StringUtils Class Reference

A collection of static methods to play with strings. More...

Static Public Member Functions
static	delimiterExplode ( $startDelim, $endDelim, $separator, $subject, $nested=false)
	Explode a string, but ignore any instances of the separator inside the given start and end delimiters, which may optionally nest.
static	delimiterReplace ( $startDelim, $endDelim, $replace, $subject, $flags='')
	Perform an operation equivalent to preg_replace() with flags.
static	escapeRegexReplacement ( $string)
	Escape a string to make it suitable for inclusion in a preg_replace() replacement parameter.
static	explode ( $separator, $subject)
	Workalike for explode() with limited memory usage.
static	hungryDelimiterReplace ( $startDelim, $endDelim, $replace, $subject)
	Perform an operation equivalent to preg_replace()
static	isUtf8 ( $value)
	Test whether a string is valid UTF-8.
static	isValidPCRERegex ( $string)
	Utility function to check if the given string is a valid PCRE regex.
static	replaceMarkup ( $search, $replace, $text)
	More or less "markup-safe" str_replace() Ignores any instances of the separator inside <...>

Detailed Description

A collection of static methods to play with strings.

Definition at line 29 of file StringUtils.php.

Member Function Documentation

delimiterExplode()

static StringUtils::delimiterExplode ( $startDelim, $endDelim, $separator, $subject, $nested = false )

static

Explode a string, but ignore any instances of the separator inside the given start and end delimiters, which may optionally nest.

The delimiters are literal strings, not regular expressions.

Parameters

string	$startDelim	Start delimiter
string	$endDelim	End delimiter
string	$separator	Separator string for the explode.
string	$subject	Subject string to explode.
bool	$nested	True iff the delimiters are allowed to nest.

Returns

ArrayIterator

Definition at line 59 of file StringUtils.php.

Referenced by Parser\makeImage(), and Parser\renderImageGallery().

delimiterReplace()

static StringUtils::delimiterReplace ( $startDelim, $endDelim, $replace, $subject, $flags = '' )

static

Perform an operation equivalent to preg_replace() with flags.

Matches this code:

preg_replace( "!$startDelim(.*)$endDelim!$flags", $replace, $subject );

Parameters

string	$startDelim	Start delimiter regular expression
string	$endDelim	End delimiter regular expression
string	$replace	Replacement string. May contain $1, which will be replaced by the text between the delimiters
string	$subject	String to search
string	$flags	Regular expression flags

Returns

string The string with the matches replaced

Definition at line 248 of file StringUtils.php.

References $matches.

Referenced by Sanitizer\normalizeCss(), and Parser\stripSectionName().

escapeRegexReplacement()

static StringUtils::escapeRegexReplacement ( $string )

static

Escape a string to make it suitable for inclusion in a preg_replace() replacement parameter.

Parameters

string

$string

Returns

string

Definition at line 314 of file StringUtils.php.

Referenced by MagicWord\replace(), FileBackendMultiWrite\substPaths(), and FileBackendMultiWrite\unsubstPaths().

explode()

static StringUtils::explode ( $separator, $subject )

static

Workalike for explode() with limited memory usage.

Parameters

string	$separator
string	$subject

Returns

ArrayIterator|ExplodeIterator

Definition at line 326 of file StringUtils.php.

References explode().

Referenced by LanguageConverter\autoConvert(), GrepPages\execute(), explode(), hungryDelimiterReplace(), and Parser\renderImageGallery().

hungryDelimiterReplace()

static StringUtils::hungryDelimiterReplace ( $startDelim, $endDelim, $replace, $subject )

static

Perform an operation equivalent to preg_replace()

Matches this code:

preg_replace( "!$startDelim(.*?)$endDelim!", $replace, $subject );

..except that it's worst-case O(N) instead of O(N^2). Compared to delimiterReplace(), this implementation is fast but memory-hungry and inflexible. The memory requirements are such that I don't recommend using it on anything but guaranteed small chunks of text.

Parameters

string	$startDelim
string	$endDelim
string	$replace
string	$subject

Returns

string

Definition at line 118 of file StringUtils.php.

References $s, and explode().

isUtf8()

static StringUtils::isUtf8 ( $value )

static

Test whether a string is valid UTF-8.

The function check for invalid byte sequences, overlong encoding but not for different normalisations.

Note

In MediaWiki 1.21, this function did not provide proper UTF-8 validation. In particular, the pure PHP code path did not in fact check for overlong forms. Beware of this when backporting code to that version of MediaWiki.

Since

1.21

Parameters

string

$value

String to check

Returns

bool Whether the given $value is a valid UTF-8 encoded string

Definition at line 44 of file StringUtils.php.

Referenced by Language\checkTitleEncoding().

isValidPCRERegex()

static StringUtils::isValidPCRERegex ( $string )

static

Utility function to check if the given string is a valid PCRE regex.

Avoids manually calling suppressWarnings and restoreWarnings, and provides a one-line solution without the need to use .

Since

1.34

Parameters

string

$string

The string you want to check being a valid regex

Returns

bool

Definition at line 299 of file StringUtils.php.

replaceMarkup()

static StringUtils::replaceMarkup ( $search, $replace, $text )

static

More or less "markup-safe" str_replace() Ignores any instances of the separator inside <...>

Parameters

string	$search
string	$replace
string	$text

Returns

string

Definition at line 268 of file StringUtils.php.

References $matches.

---

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

• includes/libs/StringUtils.php