This class encapsulates "magic words" such as #redirect, __NOTOC__, etc. More...

Public Member Functions
	__construct ($id=0, $syn=array(), $cs=false)
	#@-
	addToArray (&$array, $value)
	Adds all the synonyms of this MagicWord to an array, to allow quick lookup in a list of magic words.
	compareStringLength ($s1, $s2)
	A comparison function that returns -1, 0 or 1 depending on whether the first string is longer, the same length or shorter than the second string.
	getBaseRegex ()
	regex without the slashes and what not
	getId ()
	getRegex ()
	Gets a regex representing matching the word.
	getRegexCase ()
	Gets the regexp case modifier to use, i.e.
	getRegexStart ()
	Gets a regex matching the word, if it is at the string start.
	getSynonym ($i)
	Accesses the synonym list directly.
	getSynonyms ()
	getVariableRegex ()
	Matches the word, where $1 is a wildcard.
	getVariableStartToEndRegex ()
	Matches the entire string, where $1 is a wildcard.
	getWasModified ()
	Returns true if the last call to replace() or substituteCallback() returned a modified text, otherwise false.
	initRegex ()
	Preliminary initialisation.
	isCaseSensitive ()
	load ($id)
	Initialises this object with an ID.
	match ($text)
	Returns true if the text contains the word.
	matchAndRemove (&$text)
	Returns true if the text matches the word, and alters the input string, removing all instances of the word.
	matchStart ($text)
	Returns true if the text starts with the word.
	matchStartAndRemove (&$text)
	matchVariableStartToEnd ($text)
	Returns NULL if there's no match, the value of $1 otherwise The return code is the matched string, if there's no variable part in the regex and the matched variable part ($1) if there is one.
	pregRemoveAndRecord ()
	Used in matchAndRemove()
	replace ($replacement, $subject, $limit=-1)
	Replaces the word with something else.
	replaceMultiple ($magicarr, $subject, &$result)
	$magicarr is an associative array of (magic word ID => replacement) This method uses the php feature to do several replacements at the same time, thereby gaining some efficiency.
	substituteCallback ($text, $callback)
	Variable handling: {{SUBST:xxx}} style words Calls back a function to determine what to replace xxx with Input word must contain $1.
Static Public Member Functions
static	clearCache ()
	Clear the self::$mObjects variable For use in parser tests.
static &	get ($id)
	Factory: creates an object representing an ID.
static	getCacheTTL ($id)
	Allow external reads of TTL array.
static	getDoubleUnderscoreArray ()
	Get a MagicWordArray of double-underscore entities.
static	getSubstIDs ()
	Get an array of parser substitution modifier IDs.
static	getVariableIDs ()
	Get an array of parser variable IDs.
Public Attributes
	$mBaseRegex = ''
	$mCaseSensitive
	$mFound = false
	$mId
	#@+
	$mModified = false
	$mRegex = ''
	$mRegexStart = ''
	$mSynonyms
	$mVariableRegex = ''
	$mVariableStartToEndRegex = ''
Static Public Attributes
static	$mCacheTTLs
static	$mDoubleUnderscoreArray = null
static	$mDoubleUnderscoreIDs
static	$mObjects = array()
static	$mSubstIDs
static	$mVariableIDs
static	$mVariableIDsInitialised = false

Detailed Description

This class encapsulates "magic words" such as #redirect, __NOTOC__, etc.

Usage:

     if (MagicWord::get( 'redirect' )->match( $text ) ) {
       // some code
     }

Possible future improvements: * Simultaneous searching for a number of magic words * MagicWord::$mObjects in shared memory

Please avoid reading the data out of one of these objects and then writing special case code. If possible, add another match()-like function here.

To add magic words in an extension, use $magicWords in a file listed in $wgExtensionMessagesFiles[].

Example:

 $magicWords = array();

 $magicWords['en'] = array(
        'magicwordkey' => array( 0, 'case_insensitive_magic_word' ),
        'magicwordkey2' => array( 1, 'CASE_sensitive_magic_word2' ),
 );

For magic words which are also Parser variables, add a MagicWordwgVariableIDs hook. Use string keys.

Definition at line 46 of file MagicWord.php.

Constructor & Destructor Documentation

MagicWord::__construct	(	$	id = `0`,
		$	syn = `array()`,
		$	cs = `false`
	)

#@-

Definition at line 203 of file MagicWord.php.

Member Function Documentation

MagicWord::addToArray	(	&$	array,
		$	value
	)

Adds all the synonyms of this MagicWord to an array, to allow quick lookup in a list of magic words.

Parameters:

$array
$value

Definition at line 599 of file MagicWord.php.

References $wgContLang.

static MagicWord::clearCache ( ) [static]

Clear the self::$mObjects variable For use in parser tests.

Definition at line 277 of file MagicWord.php.

Referenced by NewParserTest\setupGlobals(), and ParserTest\setupGlobals().

Here is the caller graph for this function:

MagicWord::compareStringLength	(	$	s1,
		$	s2
	)

A comparison function that returns -1, 0 or 1 depending on whether the first string is longer, the same length or shorter than the second string.

Parameters:

$s1	string
$s2	string

Returns:: int

Definition at line 333 of file MagicWord.php.

static& MagicWord::get ( $ id ) [static]

Factory: creates an object representing an ID.

Parameters:

$id

Returns:: MagicWord

Definition at line 216 of file MagicWord.php.

Referenced by Parser\braceSubstitution(), Parser\cleanSig(), Parser\doDoubleUnderscore(), MagicWordArray\getBaseRegex(), MagicWordArray\getHash(), CoreParserFunctions\isRaw(), SpecialMergeHistory\merge(), Title\moveToInternal(), Title\newFromRedirectInternal(), Parser\renderImageGallery(), replaceMultiple(), DoubleRedirectJob\run(), and Parser\setFunctionHook().

Here is the caller graph for this function:

MagicWord::getBaseRegex ( )

regex without the slashes and what not

Returns:: string

Definition at line 388 of file MagicWord.php.

References initRegex().

Here is the call graph for this function:

static MagicWord::getCacheTTL ( $ id ) [static]

Allow external reads of TTL array.

Parameters:

$id int

Returns:: array

Definition at line 253 of file MagicWord.php.

Referenced by Parser\braceSubstitution().

Here is the caller graph for this function:

static MagicWord::getDoubleUnderscoreArray ( ) [static]

Get a MagicWordArray of double-underscore entities.

Returns:: MagicWordArray

Definition at line 266 of file MagicWord.php.

References $mDoubleUnderscoreArray.

Referenced by Parser\doDoubleUnderscore().

Here is the caller graph for this function:

MagicWord::getId ( )

Returns:: int

Definition at line 616 of file MagicWord.php.

MagicWord::getRegex ( )

Gets a regex representing matching the word.

Returns:: string

Definition at line 350 of file MagicWord.php.

References initRegex().

Referenced by match(), matchAndRemove(), and replace().

Here is the call graph for this function:

Here is the caller graph for this function:

MagicWord::getRegexCase ( )

Gets the regexp case modifier to use, i.e.

i or nothing, to be used if one is using MagicWord::getBaseRegex(), otherwise it'll be included in the complete expression

Returns:: string

Definition at line 364 of file MagicWord.php.

References initRegex().

Here is the call graph for this function:

MagicWord::getRegexStart ( )

Gets a regex matching the word, if it is at the string start.

Returns:: string

Definition at line 376 of file MagicWord.php.

References initRegex().

Referenced by matchStart(), and matchStartAndRemove().

Here is the call graph for this function:

Here is the caller graph for this function:

static MagicWord::getSubstIDs ( ) [static]

Get an array of parser substitution modifier IDs.

Returns:: array

Definition at line 243 of file MagicWord.php.

References $mSubstIDs.

Referenced by Parser\initialiseVariables().

Here is the caller graph for this function:

MagicWord::getSynonym ( $ i )

Accesses the synonym list directly.

Parameters:

$i int

Returns:: string

Definition at line 545 of file MagicWord.php.

MagicWord::getSynonyms ( )

Returns:: array

Definition at line 552 of file MagicWord.php.

static MagicWord::getVariableIDs ( ) [static]

Get an array of parser variable IDs.

Returns:: array

Definition at line 230 of file MagicWord.php.

References $mVariableIDs, and wfRunHooks().

Referenced by Parser\initialiseVariables().

Here is the call graph for this function:

Here is the caller graph for this function:

MagicWord::getVariableRegex ( )

Matches the word, where $1 is a wildcard.

Returns:: string

Definition at line 519 of file MagicWord.php.

References initRegex().

Referenced by substituteCallback().

Here is the call graph for this function:

Here is the caller graph for this function:

MagicWord::getVariableStartToEndRegex ( )

Matches the entire string, where $1 is a wildcard.

Returns:: string

Definition at line 531 of file MagicWord.php.

References initRegex().

Referenced by matchVariableStartToEnd().

Here is the call graph for this function:

Here is the caller graph for this function:

MagicWord::getWasModified ( )

Returns true if the last call to replace() or substituteCallback() returned a modified text, otherwise false.

Returns:: bool

Definition at line 562 of file MagicWord.php.

MagicWord::initRegex ( )

Preliminary initialisation.

Access:: private

Definition at line 303 of file MagicWord.php.

Referenced by getBaseRegex(), getRegex(), getRegexCase(), getRegexStart(), getVariableRegex(), and getVariableStartToEndRegex().

Here is the caller graph for this function:

MagicWord::isCaseSensitive ( )

Returns:: bool

Definition at line 609 of file MagicWord.php.

MagicWord::load ( $ id )

Initialises this object with an ID.

Parameters:

$id

Definition at line 286 of file MagicWord.php.

References $wgContLang, wfDebugLog(), wfProfileIn(), and wfProfileOut().

Here is the call graph for this function:

MagicWord::match ( $ text )

Returns true if the text contains the word.

Parameters:

$text string

Returns:: bool

Definition at line 402 of file MagicWord.php.

References getRegex().

Here is the call graph for this function:

MagicWord::matchAndRemove ( &$ text )

Returns true if the text matches the word, and alters the input string, removing all instances of the word.

Parameters:

$text string

Returns:: bool

Definition at line 457 of file MagicWord.php.

References getRegex().

Here is the call graph for this function:

MagicWord::matchStart ( $ text )

Returns true if the text starts with the word.

Parameters:

$text string

Returns:: bool

Definition at line 413 of file MagicWord.php.

References getRegexStart().

Here is the call graph for this function:

MagicWord::matchStartAndRemove ( &$ text )

Parameters:

$text

Returns:: bool

Definition at line 467 of file MagicWord.php.

References getRegexStart().

Here is the call graph for this function:

MagicWord::matchVariableStartToEnd ( $ text )

Returns NULL if there's no match, the value of $1 otherwise The return code is the matched string, if there's no variable part in the regex and the matched variable part ($1) if there is one.

Parameters:

$text string

Returns:: string

Definition at line 427 of file MagicWord.php.

References $matches, and getVariableStartToEndRegex().

Here is the call graph for this function:

MagicWord::pregRemoveAndRecord ( )

Used in matchAndRemove()

Returns:: string

Definition at line 478 of file MagicWord.php.

MagicWord::replace	(	$	replacement,
		$	subject,
		$	limit = `-1`
	)

Replaces the word with something else.

Parameters:

$replacement
$subject
$limit	int

Returns:: string

Definition at line 492 of file MagicWord.php.

References $limit, $res, StringUtils\escapeRegexReplacement(), and getRegex().

Here is the call graph for this function:

MagicWord::replaceMultiple	(	$	magicarr,
		$	subject,
		&$	result
	)

$magicarr is an associative array of (magic word ID => replacement) This method uses the php feature to do several replacements at the same time, thereby gaining some efficiency.

The result is placed in the out variable $result. The return value is true if something was replaced.

Todo:: Should this be static? It doesn't seem to be used at all

Parameters:

$magicarr
$subject
$result

Returns:: bool

Definition at line 579 of file MagicWord.php.

References $result, and get().

Here is the call graph for this function:

MagicWord::substituteCallback	(	$	text,
		$	callback
	)

Variable handling: {{SUBST:xxx}} style words Calls back a function to determine what to replace xxx with Input word must contain $1.

Parameters:

$text	string
$callback

Returns:: string

Definition at line 508 of file MagicWord.php.

References $res, and getVariableRegex().

Here is the call graph for this function:

Member Data Documentation

MagicWord::$mBaseRegex = ''

Definition at line 53 of file MagicWord.php.

MagicWord::$mCacheTTLs [static]

Definition at line 135 of file MagicWord.php.

MagicWord::$mCaseSensitive

Definition at line 50 of file MagicWord.php.

MagicWord::$mDoubleUnderscoreArray = null [static]

Definition at line 199 of file MagicWord.php.

Referenced by getDoubleUnderscoreArray().

MagicWord::$mDoubleUnderscoreIDs [static]

Initial value:

 array(
                'notoc',
                'nogallery',
                'forcetoc',
                'toc',
                'noeditsection',
                'newsectionlink',
                'nonewsectionlink',
                'hiddencat',
                'index',
                'noindex',
                'staticredirect',
                'notitleconvert',
                'nocontentconvert',
        )

Definition at line 177 of file MagicWord.php.

MagicWord::$mFound = false

Definition at line 57 of file MagicWord.php.

MagicWord::$mId

#@+

Access:: private

Definition at line 50 of file MagicWord.php.

MagicWord::$mModified = false

Definition at line 56 of file MagicWord.php.

MagicWord::$mObjects = array() [static]

Definition at line 198 of file MagicWord.php.

MagicWord::$mRegex = ''

Definition at line 51 of file MagicWord.php.

MagicWord::$mRegexStart = ''

Definition at line 52 of file MagicWord.php.

MagicWord::$mSubstIDs [static]

Initial value:

 array(
                'subst',
                'safesubst',
        )

Definition at line 193 of file MagicWord.php.

Referenced by getSubstIDs().

MagicWord::$mSynonyms

Definition at line 50 of file MagicWord.php.

MagicWord::$mVariableIDs [static]

Definition at line 60 of file MagicWord.php.

Referenced by getVariableIDs().

MagicWord::$mVariableIDsInitialised = false [static]

Definition at line 59 of file MagicWord.php.

MagicWord::$mVariableRegex = ''

Definition at line 54 of file MagicWord.php.

MagicWord::$mVariableStartToEndRegex = ''

Definition at line 55 of file MagicWord.php.

The documentation for this class was generated from the following file:

includes/MagicWord.php

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation