Resort normal UTF-8 order by putting a bunch of stuff in PUA. More...

Inheritance diagram for CustomUppercaseCollation:

[legend]

Collaboration diagram for CustomUppercaseCollation:

[legend]

Public Member Functions
	__construct (array $alphabet, Language $lang)

	getFirstLetter ( $string)
	Given a string, return the logical "first letter" to be used for grouping on category pages and so on.

	getSortKey ( $string)
	Given a string, convert it to a (hopefully short) key that can be used for efficient sorting.

Public Member Functions inherited from NumericUppercaseCollation
	__construct (Language $lang)

Public Member Functions inherited from UppercaseCollation
	__construct ()

Private Member Functions
	convertToPua ( $string)

Private Attributes
	$alphabet

array	$firstLetters

	$puaSubset

Additional Inherited Members
Static Public Member Functions inherited from Collation
static	factory ( $collationName)

static	singleton ()

Detailed Description

Resort normal UTF-8 order by putting a bunch of stuff in PUA.

This takes a bunch of characters (The alphabet) that should, be together, and converts them all to private-use-area characters so that they are all sorted in the right order relative to each other.

This renumbers characters starting at U+F3000 (Chosen to avoid conflicts with other people using private use area)

This does not support fancy things like secondary differences, etc. (It supports digraphs, trigraphs etc. though.)

It is expected most people will subclass this and just override the constructor to hard-code an alphabet.

Definition at line 40 of file CustomUppercaseCollation.php.

Constructor & Destructor Documentation

◆ __construct()

CustomUppercaseCollation::__construct	(	array	$alphabet,
		Language	$lang
	)

Note: This assumes $alphabet does not contain U+F3000-U+F3FFF

Parameters

array	$alphabet	Sorted array of uppercase characters.
Language	$lang	What language for number sorting.

Definition at line 57 of file CustomUppercaseCollation.php.

References $alphabet, and UppercaseCollation\$lang.

Member Function Documentation

◆ convertToPua()

CustomUppercaseCollation::convertToPua ( $string )

private

Definition at line 79 of file CustomUppercaseCollation.php.

Referenced by getSortKey().

◆ getFirstLetter()

CustomUppercaseCollation::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 NumericUppercaseCollation.

Definition at line 87 of file CustomUppercaseCollation.php.

References getSortKey().

◆ getSortKey()

CustomUppercaseCollation::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).