StringWriter

A character stream that collects its output in a string buffer, which can then be used to construct a string. <p> Closing a {@code StringWriter} has no effect. The methods in this class can be called after the stream has been closed without generating an {@code IOException}.

@author Mark Reinhold

class StringWriter : Writer {

this();

this(int initialSize);

void write(int c);

void write(byte[] cbuf, int off, int len);

void write(string str);

void write(string str, int off, int len);

StringWriter append(char c);

string toString();

Appender!(string) getBuffer();

void flush();

void close();

}

Constructors

this this(): Create a new string writer using the default initial string-buffer size.
this this(int initialSize): Create a new string writer using the specified initial string-buffer size.

Members

Functions

append StringWriter append(char c): Appends the specified character to this writer.
close void close(): Closing a {@code StringWriter} has no effect. The methods in this class can be called after the stream has been closed without generating an {@code IOException}.
flush void flush(): Flush the stream.
getBuffer Appender!(string) getBuffer(): Return the string buffer itself.
toString string toString(): Return the buffer's current value as a string.
write void write(int c): Write a single character.
write void write(byte[] cbuf, int off, int len): Write a portion of an array of characters.
write void write(string str): Write a string.
write void write(string str, int off, int len): Write a portion of a string.

Inherited Members

From Writer

lock Object lock;: The object used to synchronize operations on this stream. For efficiency, a character-stream object may use an object other than itself to protect critical sections. A subclass should therefore use the object in this field rather than {@code this} or a synchronized method.
write void write(int c): Writes a single character. The character to be written is contained in the 16 low-order bits of the given integer value; the 16 high-order bits are ignored.
write void write(byte[] cbuf): Writes an array of characters.
write void write(byte[] cbuf, int off, int len): Writes a portion of an array of characters.
write void write(string str): Writes a string.
write void write(string str, int off, int len): Writes a portion of a string.
append Writer append(const(char)[] csq): Appends the specified character sequence to this writer.
append Writer append(const(char)[] csq, int start, int end): Appends a subsequence of the specified character sequence to this writer. {@code Appendable}.
append Writer append(char c): Appends the specified character to this writer.
flush void flush(): Flushes the stream. If the stream has saved any characters from the various write() methods in a buffer, write them immediately to their intended destination. Then, if that destination is another character or byte stream, flush it. Thus one flush() invocation will flush all the buffers in a chain of Writers and OutputStreams.
close void close(): Closes the stream, flushing it first. Once the stream has been closed, further write() or flush() invocations will cause an IOException to be thrown. Closing a previously closed stream has no effect.