types/selectors/ContainsRegexpSelector.php

Show: inherited
Table of Contents

\ContainsRegexpSelector

Package: phing\types\selectors

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.

Parent(s)
\BaseExtendSelector < \BaseSelector < \DataType < \ProjectComponent
Author
Hans Lellelid (Phing)  
Author
Bruce Atherton (Ant)  
Version
$Revision: 526 $  

Constants

Constant  EXPRESSION_KEY = "expression"
Constant  CASE_KEY = "casesensitive"

Properties

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

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

Details
Type
\RegularExpression
Propertyprotected  $parameters= 'null'
inherited

The passed in parameter array.

Inherited from: \BaseExtendSelector::$$parameters
Default valuenullDetails
Type
n/a
Inherited_from
\BaseExtendSelector::$$parameters  
Propertyprivatestring  $userProvidedExpression= ''

The expression set from XML.
Details
Type
string

Methods

methodpubliccircularReference( ) : void
methodpublicdieOnCircularReference( ) : void
methodpublicgetCheckedRef( ) : void
methodpublicgetDescription( ) : void
methodpublicgetError( ) : void
methodprotectedgetParameters( ) : \the
inherited

Allows access to the parameters gathered and set within the <custom> tag.

Inherited from: \BaseExtendSelector::getParameters()
Returns
Type Description
\the set of parameters defined for this selector
methodpublicgetProject( ) : void
methodpublicisReference( ) : void
methodpublicisSelected( \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 the file should be selected or not
methodpubliclog( ) : void
methodpublicnoChildrenAllowed( ) : void
methodpublicparsingComplete( ) : void
methodpublicsetCasesensitive( boolean $casesensitive ) : void

Whether to ignore case in the regex match.

Parameters
Name Type Description
$casesensitive boolean

whether to pay attention to case sensitivity

methodpublicsetDescription( ) : void
methodpublicsetError( ) : void
methodpublicsetExpression( string $exp ) : void

The expression to match on within a file.

Parameters
Name Type Description
$exp string

the string that a file must contain to be selected.

methodpublicsetParameters( array $parameters ) : void

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

methodpublicsetProject( ) : void
methodpublicsetRefid( ) : void
methodpublictoString( ) : void

methodpublictooManyAttributes( ) : void
methodpublicvalidate( ) : void
methodpublicverifySettings( ) : void

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.17.1.