private static class CharSource.CharSequenceCharSource extends CharSource
Modifier and Type | Field and Description |
---|---|
private static Splitter |
LINE_SPLITTER |
protected java.lang.CharSequence |
seq |
Modifier | Constructor and Description |
---|---|
protected |
CharSequenceCharSource(java.lang.CharSequence seq) |
Modifier and Type | Method and Description |
---|---|
boolean |
isEmpty()
Returns whether the source has zero chars.
|
long |
length()
Returns the length of this source in chars, even if doing so requires opening and traversing an
entire stream.
|
Optional<java.lang.Long> |
lengthIfKnown()
Returns the size of this source in chars, if the size can be easily determined without actually
opening the data stream.
|
java.util.stream.Stream<java.lang.String> |
lines()
Opens a new
Stream for reading text one line at a time from this source. |
private java.util.Iterator<java.lang.String> |
linesIterator()
Returns an iterator over the lines in the string.
|
java.io.Reader |
openStream()
Opens a new
Reader for reading from this source. |
java.lang.String |
read()
Reads the contents of this source as a string.
|
java.lang.String |
readFirstLine()
Reads the first line of this source as a string.
|
ImmutableList<java.lang.String> |
readLines()
Reads all the lines of this source as a list of strings.
|
<T> T |
readLines(LineProcessor<T> processor)
Reads lines of text from this source, processing each line as it is read using the given
processor . |
java.lang.String |
toString() |
asByteSource, concat, concat, concat, copyTo, copyTo, empty, forEachLine, openBufferedStream, wrap
private static final Splitter LINE_SPLITTER
protected final java.lang.CharSequence seq
protected CharSequenceCharSource(java.lang.CharSequence seq)
public java.io.Reader openStream()
CharSource
Reader
for reading from this source. This method returns a new, independent
reader each time it is called.
The caller is responsible for ensuring that the returned reader is closed.
openStream
in class CharSource
public java.lang.String read()
CharSource
read
in class CharSource
public boolean isEmpty()
CharSource
CharSource.lengthIfKnown()
, returning true if it's known to be zero and false if it's known to be
non-zero. If the length is not known, it falls back to opening a stream and checking for EOF.
Note that, in cases where lengthIfKnown
returns zero, it is possible that
chars are actually available for reading. This means that a source may return true
from
isEmpty()
despite having readable content.
isEmpty
in class CharSource
public long length()
CharSource
CharSource.lengthIfKnown()
.
The default implementation calls CharSource.lengthIfKnown()
and returns the value if present. If
absent, it will fall back to a heavyweight operation that will open a stream, skip
to the end of the stream, and return the total number of chars that
were skipped.
Note that for sources that implement CharSource.lengthIfKnown()
to provide a more efficient
implementation, it is possible that this method will return a different number of chars
than would be returned by reading all of the chars.
In either case, for mutable sources such as files, a subsequent read may return a different number of chars if the contents are changed.
length
in class CharSource
public Optional<java.lang.Long> lengthIfKnown()
CharSource
The default implementation returns Optional.absent()
. Some sources, such as a CharSequence
, may return a non-absent value. Note that in such cases, it is possible
that this method will return a different number of chars than would be returned by reading all
of the chars.
Additionally, for mutable sources such as StringBuilder
s, a subsequent read may
return a different number of chars if the contents are changed.
lengthIfKnown
in class CharSource
private java.util.Iterator<java.lang.String> linesIterator()
public java.util.stream.Stream<java.lang.String> lines()
CharSource
Stream
for reading text one line at a time from this source. This method
returns a new, independent stream each time it is called.
The returned stream is lazy and only reads from the source in the terminal operation. If an
I/O error occurs while the stream is reading from the source or when the stream is closed, an
UncheckedIOException
is thrown.
Like BufferedReader.readLine()
, this method considers a line to be a sequence of
text that is terminated by (but does not include) one of \r\n
, \r
or \n
. If the source's content does not end in a line termination sequence, it is treated as if
it does.
The caller is responsible for ensuring that the returned stream is closed. For example:
try (Stream<String> lines = source.lines()) {
lines.map(...)
.filter(...)
.forEach(...);
}
lines
in class CharSource
public java.lang.String readFirstLine()
CharSource
null
if this source is empty.
Like BufferedReader.readLine()
, this method considers a line to be a sequence of
text that is terminated by (but does not include) one of \r\n
, \r
or \n
. If the source's content does not end in a line termination sequence, it is treated as if
it does.
readFirstLine
in class CharSource
public ImmutableList<java.lang.String> readLines()
CharSource
Like BufferedReader.readLine()
, this method considers a line to be a sequence of
text that is terminated by (but does not include) one of \r\n
, \r
or \n
. If the source's content does not end in a line termination sequence, it is treated as if
it does.
readLines
in class CharSource
public <T> T readLines(LineProcessor<T> processor) throws java.io.IOException
CharSource
processor
. Stops when all lines have been processed or the processor returns
false
and returns the result produced by the processor.
Like BufferedReader.readLine()
, this method considers a line to be a sequence of
text that is terminated by (but does not include) one of \r\n
, \r
or \n
. If the source's content does not end in a line termination sequence, it is treated as if
it does.
readLines
in class CharSource
java.io.IOException
- if an I/O error occurs while reading from this source or if processor
throws an IOException
public java.lang.String toString()
toString
in class java.lang.Object