MediaWiki REL1_39
Public Member Functions | Static Public Member Functions | List of all members
Collation Class Reference
Inheritance diagram for Collation:
Inheritance graph
[legend]

Public Member Functions

 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.
 
 getSortKeys ( $strings)
 Get multiple sort keys.
 

Static Public Member Functions

static factory ( $collationName)
 
static singleton ()
 

Detailed Description

Since
1.16.3
Author
Tim Starling
Stability: stable
to extend

Definition at line 31 of file Collation.php.

Member Function Documentation

◆ factory()

static Collation::factory ( $collationName)
static
Since
1.16.3
Deprecated
since 1.37 Use MediaWikiServices::getCollationFactory()->makeCollation()
Exceptions
MWException
Parameters
string$collationName
Returns
Collation

Definition at line 56 of file Collation.php.

References wfDeprecated().

Referenced by singleton().

◆ getFirstLetter()

Collation::getFirstLetter ( $string)
abstract

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$stringUTF-8 string
Returns
string UTF-8 string corresponding to the first letter of input

Reimplemented in CustomUppercaseCollation, IcuCollation, IdentityCollation, NumericUppercaseCollation, RemoteIcuCollation, and UppercaseCollation.

◆ getSortKey()

Collation::getSortKey ( $string)
abstract

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$stringUTF-8 string
Returns
string Binary sortkey

Reimplemented in CustomUppercaseCollation, IcuCollation, IdentityCollation, NumericUppercaseCollation, RemoteIcuCollation, and UppercaseCollation.

Referenced by getSortKeys().

◆ getSortKeys()

Collation::getSortKeys ( $strings)

Get multiple sort keys.

Parameters
string[]$strings
Returns
string[]

Reimplemented in RemoteIcuCollation.

Definition at line 82 of file Collation.php.

References $s, and getSortKey().

◆ singleton()

static Collation::singleton ( )
static
Deprecated
since 1.37 Use MediaWikiServices::getCollationFactory()->getCategoryCollation()
Since
1.16.3
Returns
Collation

Definition at line 39 of file Collation.php.

References factory(), and wfDeprecated().

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