Return type | Name and parameters |
---|---|
Object
|
eachLine(Closure closure)
Iterates through the given reader line by line. |
Object
|
eachLine(int firstLine, Closure closure)
Iterates through the given reader line by line. |
Writable
|
filterLine(Closure closure)
Filter the lines from this Reader, and return a Writable which can be used to stream the filtered lines to a destination. |
void
|
filterLine(Writer writer, Closure closure)
Filter the lines from a reader and write them on the writer, according to a closure which returns true if the line should be included. |
String
|
getText()
Read the content of the Reader and return it as a String. |
Iterator
|
iterator()
Creates an iterator which will traverse through the reader a line at a time. |
String
|
readLine()
Read a single, whole line from the given Reader. |
List
|
readLines()
Reads the reader into a list of Strings, with one entry for each line. |
Object
|
splitEachLine(String regex, Closure closure)
Iterates through the given reader line by line, splitting each line using the given regex separator. |
Object
|
splitEachLine(Pattern pattern, Closure closure)
Iterates through the given reader line by line, splitting each line using the given regex separator Pattern. |
void
|
transformChar(Writer writer, Closure closure)
Transforms each character from this reader by passing it to the given closure. |
void
|
transformLine(Writer writer, Closure closure)
Transforms the lines from a reader with a Closure and write them to a writer. |
Object
|
withReader(Closure closure)
Allows this reader to be used within the closure, ensuring that it is closed before this method returns. |
addShutdownHook
, any
, any
, asBoolean
, asType
, collect
, collect
, collect
, dump
, each
, eachMatch
, eachMatch
, eachWithIndex
, every
, every
, find
, find
, findAll
, findAll
, findIndexOf
, findIndexOf
, findIndexValues
, findIndexValues
, findLastIndexOf
, findLastIndexOf
, findResult
, findResult
, findResult
, findResult
, getAt
, getMetaClass
, getMetaPropertyValues
, getProperties
, grep
, grep
, hasProperty
, identity
, inject
, inject
, inspect
, invokeMethod
, is
, isCase
, isNotCase
, iterator
, metaClass
, print
, print
, printf
, printf
, println
, println
, println
, putAt
, respondsTo
, respondsTo
, setMetaClass
, split
, sprintf
, sprintf
, stream
, tap
, toString
, use
, use
, use
, with
, with
, withCloseable
, withStream
, withTraits
Iterates through the given reader line by line. Each line is passed to the given 1 or 2 arg closure. If the closure has two arguments, the line count is passed as the second argument. The Reader is closed before this method returns.
closure
- a closure (arg 1 is line, optional arg 2 is line number starting at line 1)Iterates through the given reader line by line. Each line is passed to the given 1 or 2 arg closure. If the closure has two arguments, the line count is passed as the second argument. The Reader is closed before this method returns.
firstLine
- the line number value used for the first line (default is 1, set to 0 to start counting from 0)closure
- a closure which will be passed each line (or for 2 arg closures the line and line count)Filter the lines from this Reader, and return a Writable which can be
used to stream the filtered lines to a destination. The closure should
return true
if the line should be passed to the writer.
closure
- a closure used for filteringFilter the lines from a reader and write them on the writer, according to a closure which returns true if the line should be included. Both Reader and Writer are closed after the operation.
writer
- a writer, closed after the callclosure
- the closure which returns booleansRead the content of the Reader and return it as a String. The reader is closed before this method returns.
Creates an iterator which will traverse through the reader a line at a time.
Read a single, whole line from the given Reader. This method is designed for use with
Readers that support the mark()
operation like BufferReader. It has a fallback
behavior for Readers that don't support mark() but the behavior doesn't correctly
detect multi-character line termination (e.g. carriage return followed by linefeed).
We recommend for Readers that don't support mark() you consider using one of the
following methods instead: eachLine, readLines, or iterator.
Reads the reader into a list of Strings, with one entry for each line. The reader is closed before this method returns.
Iterates through the given reader line by line, splitting each line using the given regex separator. For each line, the given closure is called with a single parameter being the list of strings computed by splitting the line around matches of the given regular expression. The Reader is closed afterwards.
Here is an example:
def s = 'The 3 quick\nbrown 4 fox'
def result = ''
new StringReader(s).splitEachLine(/\d/){ parts ->
result += "${parts[0]}_${parts[1]}|"
}
assert result == 'The _ quick|brown _ fox|'
regex
- the delimiting regular expressionclosure
- a closureIterates through the given reader line by line, splitting each line using the given regex separator Pattern. For each line, the given closure is called with a single parameter being the list of strings computed by splitting the line around matches of the given regular expression. The Reader is closed afterwards.
Here is an example:
def s = 'The 3 quick\nbrown 4 fox'
def result = ''
new StringReader(s).splitEachLine(~/\d/){ parts ->
result += "${parts[0]}_${parts[1]}|"
}
assert result == 'The _ quick|brown _ fox|'
pattern
- the regular expression Pattern for the delimiterclosure
- a closureTransforms each character from this reader by passing it to the given closure. The Closure should return each transformed character, which will be passed to the Writer. The reader and writer will both be closed before this method returns.
writer
- a Writer to receive the transformed charactersclosure
- a closure that performs the required transformationTransforms the lines from a reader with a Closure and write them to a writer. Both Reader and Writer are closed after the operation.
writer
- Where transformed lines are written. Writer is closed afterwards.closure
- Single parameter closure that is called to transform each line of
text from the reader, before writing it to the writer.