Class CharStreams
- Since:
- 1.0
- Author:
- Chris Nokleberg, Bin Zhu, Colin Decker
-
Method Summary
Modifier and TypeMethodDescriptionstatic Writer
asWriter
(Appendable target) Returns a Writer that sends all output to the givenAppendable
target.static long
copy
(Readable from, Appendable to) Copies all characters between theReadable
andAppendable
objects.static long
Reads and discards data from the givenReadable
until the end of the stream is reached.static Writer
Returns aWriter
that simply discards written chars.Reads all of the lines from aReadable
object.readLines
(Readable readable, LineProcessor<T> processor) Streams lines from aReadable
object, stopping when the processor returnsfalse
or all lines have been read and returning the result produced by the processor.static void
Discardsn
characters of data from the reader.static String
-
Method Details
-
copy
Copies all characters between theReadable
andAppendable
objects. Does not close or flush either object.- Parameters:
from
- the object to read fromto
- the object to write to- Returns:
- the number of characters copied
- Throws:
IOException
- if an I/O error occurs
-
toString
Reads all characters from aReadable
object into aString
. Does not close theReadable
.Java 25+ users: If the input is a
Reader
, preferReader.readAllAsString()
.- Parameters:
r
- the object to read from- Returns:
- a string containing all the characters
- Throws:
IOException
- if an I/O error occurs
-
readLines
Reads all of the lines from aReadable
object. The lines do not include line-termination characters, but do include other leading and trailing whitespace.Does not close the
Readable
. If reading files or resources you should use theFiles.readLines(File, Charset)
andResources.readLines(URL, Charset, LineProcessor)
methods.This method prioritizes convenience over performance: It reads the entire input into memory immediately. To instead read and process lines individually, use an alternative like
BufferedReader.lines()
.Java 25+ users: If the input is a
Reader
, you may preferReader.readAllLines()
. The two may have different performance characteristics for differentReader
classes and Java versions, but both methods read the entire input into memory immediately, so we discourage use of both when memory usage is a concern.- Parameters:
r
- the object to read from- Returns:
- a mutable
List
containing all the lines - Throws:
IOException
- if an I/O error occurs
-
readLines
@CanIgnoreReturnValue public static <T extends @Nullable Object> T readLines(Readable readable, LineProcessor<T> processor) throws IOException Streams lines from aReadable
object, stopping when the processor returnsfalse
or all lines have been read and returning the result produced by the processor. Does not closereadable
. Note that this method may not fully consume the contents ofreadable
if the processor stops processing early.Users who can use
Stream
: If your input is aReader
, consider wrapping it with aBufferedReader
and operating on theStream
of lines returned byBufferedReader.lines()
.- Throws:
IOException
- if an I/O error occurs- Since:
- 14.0
-
exhaust
Reads and discards data from the givenReadable
until the end of the stream is reached. Returns the total number of chars read. Does not close the stream.- Throws:
IOException
- Since:
- 20.0
-
skipFully
Discardsn
characters of data from the reader. This method will block until the full amount has been skipped. Does not close the reader.- Parameters:
reader
- the reader to read fromn
- the number of characters to skip- Throws:
EOFException
- if this stream reaches the end before skipping all the charactersIOException
- if an I/O error occurs
-
nullWriter
Returns aWriter
that simply discards written chars.Java 11+ users: use
Writer.nullWriter()
instead. Note that theCharStreams
method returns a singleton writer whoseclose
method has no effect, while theWriter.nullWriter()
method returns a new instance whose methods throw after the instance isclosed
.- Since:
- 15.0
-
asWriter
Returns a Writer that sends all output to the givenAppendable
target. Closing the writer will close the target if it isCloseable
, and flushing the writer will flush the target if it isFlushable
.- Parameters:
target
- the object to which output will be sent- Returns:
- a new Writer object, unless target is a Writer, in which case the target is returned
-