An output stream that writes into a local file. More...
#include <juce_FileOutputStream.h>
Public Member Functions | |
FileOutputStream (const File &fileToWriteTo, size_t bufferSizeToUse=16384) | |
Creates a FileOutputStream. More... | |
~FileOutputStream () override | |
Destructor. More... | |
bool | failedToOpen () const noexcept |
Returns true if the stream couldn't be opened for some reason. More... | |
void | flush () override |
If the stream is using a buffer, this will ensure it gets written out to the destination. More... | |
const File & | getFile () const |
Returns the file that this stream is writing to. More... | |
const String & | getNewLineString () const noexcept |
Returns the current new-line string that was set by setNewLineString(). More... | |
int64 | getPosition () override |
Returns the stream's current position. More... | |
const Result & | getStatus () const noexcept |
Returns the status of the file stream. More... | |
bool | openedOk () const noexcept |
Returns true if the stream opened without problems. More... | |
void | setNewLineString (const String &newLineString) |
Sets the string to write to the stream when a new line is written. More... | |
bool | setPosition (int64) override |
Tries to move the stream's output position. More... | |
Result | truncate () |
Attempts to truncate the file to the current write position. More... | |
bool | write (const void *, size_t) override |
Writes a block of data to the stream. More... | |
virtual bool | writeBool (bool boolValue) |
Writes a boolean to the stream as a single byte. More... | |
virtual bool | writeByte (char byte) |
Writes a single byte to the stream. More... | |
virtual bool | writeCompressedInt (int value) |
Writes a condensed binary encoding of a 32-bit integer. More... | |
virtual bool | writeDouble (double value) |
Writes a 64-bit floating point value to the stream in a binary format. More... | |
virtual bool | writeDoubleBigEndian (double value) |
Writes a 64-bit floating point value to the stream in a binary format. More... | |
virtual bool | writeFloat (float value) |
Writes a 32-bit floating point value to the stream in a binary format. More... | |
virtual bool | writeFloatBigEndian (float value) |
Writes a 32-bit floating point value to the stream in a binary format. More... | |
virtual int64 | writeFromInputStream (InputStream &source, int64 maxNumBytesToWrite) |
Reads data from an input stream and writes it to this stream. More... | |
virtual bool | writeInt (int value) |
Writes a 32-bit integer to the stream in a little-endian byte order. More... | |
virtual bool | writeInt64 (int64 value) |
Writes a 64-bit integer to the stream in a little-endian byte order. More... | |
virtual bool | writeInt64BigEndian (int64 value) |
Writes a 64-bit integer to the stream in a big-endian byte order. More... | |
virtual bool | writeIntBigEndian (int value) |
Writes a 32-bit integer to the stream in a big-endian byte order. More... | |
bool | writeRepeatedByte (uint8 byte, size_t numTimesToRepeat) override |
Writes a byte to the output stream a given number of times. More... | |
virtual bool | writeShort (short value) |
Writes a 16-bit integer to the stream in a little-endian byte order. More... | |
virtual bool | writeShortBigEndian (short value) |
Writes a 16-bit integer to the stream in a big-endian byte order. More... | |
virtual bool | writeString (const String &text) |
Stores a string in the stream in a binary format. More... | |
virtual bool | writeText (const String &text, bool asUTF16, bool writeUTF16ByteOrderMark, const char *lineEndings) |
Writes a string of text to the stream. More... | |
Private Member Functions | |
void | closeHandle () |
bool | flushBuffer () |
void | flushInternal () |
void | openHandle () |
int64 | setPositionInternal (int64) |
ssize_t | writeInternal (const void *, size_t) |
Private Attributes | |
HeapBlock< char > | buffer |
size_t | bufferSize |
size_t | bytesInBuffer = 0 |
int64 | currentPosition = 0 |
File | file |
void * | fileHandle = nullptr |
String | newLineString |
Result | status { Result::ok() } |
An output stream that writes into a local file.
@tags{Core}
juce::FileOutputStream::FileOutputStream | ( | const File & | fileToWriteTo, |
size_t | bufferSizeToUse = 16384 |
||
) |
Creates a FileOutputStream.
If the file doesn't exist, it will first be created. If the file can't be created or opened (for example, because the parent directory of the file does not exist), the failedToOpen() method will return true.
If the file already exists when opened, the stream's write-position will be set to the end of the file. To overwrite an existing file, you can truncate it like this:
Destroying a FileOutputStream object does not force the operating system to write the buffered data to disk immediately. If this is required you should call flush() before triggering the destructor.
|
override |
Destructor.
|
private |
References fileHandle, and juce::anonymous_namespace{juce_posix_SharedCode.h}::getFD().
|
inlinenoexcept |
Returns true if the stream couldn't be opened for some reason.
|
overridevirtual |
If the stream is using a buffer, this will ensure it gets written out to the destination.
Implements juce::OutputStream.
Referenced by truncate().
|
private |
|
private |
|
inline |
Returns the file that this stream is writing to.
|
inlinenoexceptinherited |
Returns the current new-line string that was set by setNewLineString().
|
overridevirtual |
|
inlinenoexcept |
Returns the status of the file stream.
The result will be ok if the file opened successfully. If an error occurs while opening or writing to the file, this will contain an error message.
|
inlinenoexcept |
Returns true if the stream opened without problems.
|
private |
|
inherited |
Sets the string to write to the stream when a new line is written.
By default this will be set the value of NewLine::getDefault().
Tries to move the stream's output position.
Not all streams will be able to seek to a new position - this will return false if it fails to work.
Implements juce::OutputStream.
Result juce::FileOutputStream::truncate | ( | ) |
Attempts to truncate the file to the current write position.
To truncate a file to a specific size, first use setPosition() to seek to the appropriate location, and then call this method.
References currentPosition, fileHandle, flush(), juce::anonymous_namespace{juce_posix_SharedCode.h}::getFD(), juce::anonymous_namespace{juce_posix_SharedCode.h}::getResultForReturnValue(), and status.
|
overridevirtual |
Writes a block of data to the stream.
When creating a subclass of OutputStream, this is the only write method that needs to be overloaded - the base class has methods for writing other types of data which use this to do the work.
dataToWrite | the target buffer to receive the data. This must not be null. |
numberOfBytes | the number of bytes to write. |
Implements juce::OutputStream.
Referenced by writeInternal().
Writes a boolean to the stream as a single byte.
This is encoded as a binary byte (not as text) with a value of 1 or 0.
|
virtualinherited |
Writes a single byte to the stream.
Writes a condensed binary encoding of a 32-bit integer.
If you're storing a lot of integers which are unlikely to have very large values, this can save a lot of space, because values under 0xff will only take up 2 bytes, under 0xffff only 3 bytes, etc.
The format used is: number of significant bytes + up to 4 bytes in little-endian order.
|
virtualinherited |
Writes a 64-bit floating point value to the stream in a binary format.
The eight raw bytes of the double value are written out as a little-endian 64-bit int.
|
virtualinherited |
Writes a 64-bit floating point value to the stream in a binary format.
The eight raw bytes of the double value are written out as a big-endian 64-bit int.
Writes a 32-bit floating point value to the stream in a binary format.
The binary 32-bit encoding of the float is written as a little-endian int.
Writes a 32-bit floating point value to the stream in a binary format.
The binary 32-bit encoding of the float is written as a big-endian int.
|
virtualinherited |
Reads data from an input stream and writes it to this stream.
source | the stream to read from |
maxNumBytesToWrite | the number of bytes to read from the stream (if this is less than zero, it will keep reading until the input is exhausted) |
Reimplemented in juce::MemoryOutputStream.
Writes a 32-bit integer to the stream in a little-endian byte order.
Writes a 64-bit integer to the stream in a little-endian byte order.
Writes a 64-bit integer to the stream in a big-endian byte order.
Writes a 32-bit integer to the stream in a big-endian byte order.
|
private |
|
overridevirtual |
Writes a byte to the output stream a given number of times.
Reimplemented from juce::OutputStream.
|
virtualinherited |
Writes a 16-bit integer to the stream in a little-endian byte order.
This will write two bytes to the stream: (value & 0xff), then (value >> 8).
|
virtualinherited |
Writes a 16-bit integer to the stream in a big-endian byte order.
This will write two bytes to the stream: (value >> 8), then (value & 0xff).
Stores a string in the stream in a binary format.
This isn't the method to use if you're trying to append text to the end of a text-file! It's intended for storing a string so that it can be retrieved later by InputStream::readString().
It writes the string to the stream as UTF8, including the null termination character.
For appending text to a file, instead use writeText, or operator<<
|
virtualinherited |
Writes a string of text to the stream.
It can either write the text as UTF-8 or UTF-16, and can also add the UTF-16 byte-order-mark bytes (0xff, 0xfe) to indicate the endianness (these should only be used at the start of a file).
If lineEndings is nullptr, then line endings in the text won't be modified. If you pass "\\n" or "\\r\\n" then this function will replace any existing line feeds.
|
private |
|
private |
|
private |
|
private |
Referenced by openHandle(), and truncate().
|
private |
Referenced by openHandle().
|
private |
Referenced by closeHandle(), openHandle(), truncate(), and writeInternal().
|
privateinherited |
|
private |
Referenced by openHandle(), truncate(), and writeInternal().