- All Implemented Interfaces:
- Closeable,- Flushable,- Appendable,- AutoCloseable
 Closing a StringWriter has no effect. The methods in this class
 can be called after the stream has been closed without generating an
 IOException.
- Since:
- 1.1
- 
Field Summary
- 
Constructor SummaryConstructorsConstructorDescriptionCreate a new string writer using the default initial string-buffer size.StringWriter(int initialSize) Create a new string writer using the specified initial string-buffer size.
- 
Method SummaryModifier and TypeMethodDescriptionappend(char c) Appends the specified character to this writer.append(CharSequence csq) Appends the specified character sequence to this writer.append(CharSequence csq, int start, int end) Appends a subsequence of the specified character sequence to this writer.voidclose()Closing aStringWriterhas no effect.voidflush()Flush the stream.Return the string buffer itself.toString()Return the buffer's current value as a string.voidwrite(char[] cbuf, int off, int len) Write a portion of an array of characters.voidwrite(int c) Write a single character.voidWrite a string.voidWrite a portion of a string.Methods declared in class java.io.WriternullWriter, write
- 
Constructor Details- 
StringWriterpublic StringWriter()Create a new string writer using the default initial string-buffer size.
- 
StringWriterpublic StringWriter(int initialSize) Create a new string writer using the specified initial string-buffer size.- Parameters:
- initialSize- The number of- charvalues that will fit into this buffer before it is automatically expanded
- Throws:
- IllegalArgumentException- If- initialSizeis negative
 
 
- 
- 
Method Details- 
writepublic void write(int c) Write a single character.
- 
writepublic void write(char[] cbuf, int off, int len) Write a portion of an array of characters.- Specified by:
- writein class- Writer
- Parameters:
- cbuf- Array of characters
- off- Offset from which to start writing characters
- len- Number of characters to write
- Throws:
- IndexOutOfBoundsException- If- offis negative, or- lenis negative, or- off + lenis negative or greater than the length of the given array
 
- 
writeWrite a string.
- 
writeWrite a portion of a string.- Overrides:
- writein class- Writer
- Parameters:
- str- String to be written
- off- Offset from which to start writing characters
- len- Number of characters to write
- Throws:
- IndexOutOfBoundsException- If- offis negative, or- lenis negative, or- off + lenis negative or greater than the length of the given string
 
- 
appendAppends the specified character sequence to this writer.An invocation of this method of the form out.append(csq)behaves in exactly the same way as the invocationout.write(csq.toString())Depending on the specification of toStringfor the character sequencecsq, the entire sequence may not be appended. For instance, invoking thetoStringmethod of a character buffer will return a subsequence whose content depends upon the buffer's position and limit.- Specified by:
- appendin interface- Appendable
- Overrides:
- appendin class- Writer
- Parameters:
- csq- The character sequence to append. If- csqis- null, then the four characters- "null"are appended to this writer.
- Returns:
- This writer
- Since:
- 1.5
 
- 
appendAppends a subsequence of the specified character sequence to this writer.An invocation of this method of the form out.append(csq, start, end)whencsqis notnull, behaves in exactly the same way as the invocationout.write(csq.subSequence(start, end).toString())- Specified by:
- appendin interface- Appendable
- Overrides:
- appendin class- Writer
- Parameters:
- csq- The character sequence from which a subsequence will be appended. If- csqis- null, then characters will be appended as if- csqcontained the four characters- "null".
- start- The index of the first character in the subsequence
- end- The index of the character following the last character in the subsequence
- Returns:
- This writer
- Throws:
- IndexOutOfBoundsException- If- startor- endare negative,- startis greater than- end, or- endis greater than- csq.length()
- Since:
- 1.5
 
- 
appendAppends the specified character to this writer.An invocation of this method of the form out.append(c)behaves in exactly the same way as the invocationout.write(c)- Specified by:
- appendin interface- Appendable
- Overrides:
- appendin class- Writer
- Parameters:
- c- The 16-bit character to append
- Returns:
- This writer
- Since:
- 1.5
 
- 
toStringReturn the buffer's current value as a string.
- 
getBufferReturn the string buffer itself.- Returns:
- StringBuffer holding the current buffer value.
 
- 
flushpublic void flush()Flush the stream.The flushmethod ofStringWriterdoes nothing.
- 
closeClosing aStringWriterhas no effect. The methods in this class can be called after the stream has been closed without generating anIOException.- Specified by:
- closein interface- AutoCloseable
- Specified by:
- closein interface- Closeable
- Specified by:
- closein class- Writer
- Throws:
- IOException- If an I/O error occurs
 
 
-