Filter which includes only those lines that contain the user-specified regular expression matching strings.
Example:
Or:
This will fetch all those lines that contain the pattern foo
author |
Yannick Lecaillez yl@seasonfive.com |
---|---|
author |
Hans Lellelid hans@xmpl.org |
version |
$Id$ |
see | |
package |
phing.filters |
read(int $len = null)
If length is specified, then only that number of chars is read, otherwise stream is read until EOF.
int
createRegexp() : object
object
regExp The regexp
element added.
setRegexps($regexps)
getRegexps() : array
array
The array of regular expressions which must be contained within a line read from the original stream in order for it to match this filter. The returned object is "live" - in other words, changes made to the returned object are mirrored in the filter.
chain(\Reader $reader) : object
object
A new filter based on this configuration, but filtering the specified reader
_initialize()
setParameters($parameters)
getParameters()
getInitialized() : boolean
boolean
whether or not the filter is initialized
setInitialized(boolean $initialized)
boolean
Whether or not the filter is initialized.
setProject(object $project)
object
The project this filter is part of.
Should not be null
.
getProject() : object
object
The project this filter is part of
readLine() : \the
The returned String retains the '\n'.
throws |
if the underlying reader throws one during reading |
---|
\the
line read, or null
if the end of the
stream has already been reached
eof() : boolean
boolean
log(string $msg, int $level = \Project::MSG_INFO)
string
Message to log.
int
Priority level.
skip(int $n)
int
reset()
close()
throws |
if there is an error closing stream |
---|
getResource() : string
This is critical for, e.g., ExpatParser's ability to know the filename that is throwing an ExpatParserException, etc.
string
mark()
A subsequent call to reset() will move stream position back to last marker (if supported).
markSupported() : boolean
boolean
ready() : boolean
boolean
REGEXP_KEY
var |
---|
_regexps : array
var |
---|
array
_parameters :
initialized :
project :