classes/phing/types/selectors/ContainsRegexpSelector.php

\ContainsRegexpSelector

Selector that filters files based on whether they contain a particular string using regexp.

It provides support for gathering the parameters together as well as for assigning an error message and throwing a build exception if an error is detected.

Extends from
\BaseExtendSelector
author
Hans Lellelid (Phing)
author
Bruce Atherton (Ant)
package
phing.types.selectors
version
$Revision: 526 $

Constants

Constant  EXPRESSION_KEY = 'expression'
Constant  CASE_KEY = 'casesensitive'

Properties

Propertyprivate  $casesensitive= 'true'
Default valuetrueDetails
Type
Propertyprivate\Regexp  $myExpression= ''

Details
Type
\Regexp
Propertyprivate\RegularExpression  $myRegExp= ''

Details
Type
\RegularExpression
Propertyprivatestring  $userProvidedExpression= ''

The expression set from XML.
Details
Type
string

Methods

methodpublic  isSelected( \basedir $basedir, \filename $filename, \file $file ) : \whether
The heart of the matter. This is where the selector gets to decide on the inclusion of a file in a particular fileset.
Parameters
Name Type Description
$basedir \basedir the base directory the scan is being done from
$filename \filename is the name of the file to check
$file \file a PhingFile object the selector can use
Returns
Type Description
\whether
methodpublic  setCasesensitive( boolean $casesensitive ) :
Whether to ignore case in the regex match.
Parameters
Name Type Description
$casesensitive boolean whether to pay attention to case sensitivity
methodpublic  setExpression( string $exp ) :
The expression to match on within a file.
Parameters
Name Type Description
$exp string the string that a file must contain to be selected.
methodpublic  setParameters( array $parameters ) :
When using this as a custom selector, this method will be called.

It translates each parameter into the appropriate setXXX() call.

Parameters
Name Type Description
$parameters array the complete set of parameters for this selector
methodpublic  toString( ) :
methodpublic  verifySettings( ) :
Checks to make sure all settings are kosher. In this case, it means that the pattern attribute has been set.
Documentation was generated by DocBlox 0.13.1.