An ICU collation that uses a remote server to compute sort keys. More...

Collaboration diagram for MediaWiki\Collation\RemoteIcuCollation:

Public Member Functions

__construct (ShellboxClientFactory $shellboxClientFactory, string $locale)

getFirstLetter ( $string)

Given a string, return the logical "first letter" to be used for grouping on category pages and so on.This has to be coordinated carefully with convertToSortkey(), or else the sorted list might jump back and forth between the same "initial letters" or other pathological behavior. For instance, if you just return the first character, but "a" sorts the same as "A" based on getSortKey(), then you might get a list like== A ==

[[Aardvark]]

== a ==

[[antelope]]

== A ==

[[Ape]]

etc., assuming for the sake of argument that $wgCapitalLinks is false.

Since: 1.16.3

Parameters

string $string UTF-8 string

Returns: string UTF-8 string corresponding to the first letter of input

getSortKey ( $string)

Given a string, convert it to a (hopefully short) key that can be used for efficient sorting.A binary sort according to the sortkeys corresponds to a logical sort of the corresponding strings. Current code expects that a line feed character should sort before all others, but has no other particular expectations (and that one can be changed if necessary).

Since: 1.16.3

Parameters

string $string UTF-8 string

Returns: string Binary sortkey

getSortKeys ( $strings)

Get multiple sort keys.

Parameters

string[] $strings

Returns: string[]

Static Public Member Functions
static	doGetSortKeys ( $locale, $blob)
	The remote entry point.

Detailed Description

An ICU collation that uses a remote server to compute sort keys.

This can be used in conjunction with $wgTempCategoryCollations to migrate to a different version of ICU.

Definition at line 15 of file RemoteIcuCollation.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Collation\RemoteIcuCollation::__construct	(	ShellboxClientFactory	$shellboxClientFactory,
		string	$locale )

Definition at line 19 of file RemoteIcuCollation.php.

References MediaWiki\Shell\ShellboxClientFactory\getRpcClient().

Member Function Documentation

◆ doGetSortKeys()

static MediaWiki\Collation\RemoteIcuCollation::doGetSortKeys	(		$locale,
			$blob )

static

The remote entry point.

Get sort keys for an encoded list of inputs.

Parameters

string	$locale	The ICU locale
string	$blob	The input array encoded with encode()

Returns: string The encoded result

Definition at line 98 of file RemoteIcuCollation.php.

◆ getFirstLetter()

MediaWiki\Collation\RemoteIcuCollation::getFirstLetter ( $string )

Given a string, return the logical "first letter" to be used for grouping on category pages and so on.This has to be coordinated carefully with convertToSortkey(), or else the sorted list might jump back and forth between the same "initial letters" or other pathological behavior. For instance, if you just return the first character, but "a" sorts the same as "A" based on getSortKey(), then you might get a list like== A ==

[[Aardvark]]

== a ==

[[antelope]]

== A ==

[[Ape]]

etc., assuming for the sake of argument that $wgCapitalLinks is false.

Since: 1.16.3

Parameters

string $string UTF-8 string

Returns: string UTF-8 string corresponding to the first letter of input

Reimplemented from MediaWiki\Collation\Collation.

Definition at line 86 of file RemoteIcuCollation.php.

◆ getSortKey()

MediaWiki\Collation\RemoteIcuCollation::getSortKey ( $string )

Given a string, convert it to a (hopefully short) key that can be used for efficient sorting.A binary sort according to the sortkeys corresponds to a logical sort of the corresponding strings. Current code expects that a line feed character should sort before all others, but has no other particular expectations (and that one can be changed if necessary).