MediaWiki  REL1_22
Collation Class Reference
Inheritance diagram for Collation:

List of all members.

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.

Static Public Member Functions

static factory ($collationName)
static singleton ()

Static Public Attributes

static $instance

Detailed Description

Definition at line 23 of file Collation.php.


Member Function Documentation

static Collation::factory ( collationName) [static]
Exceptions:
MWException
Parameters:
$collationNamestring
Returns:
Collation

Definition at line 42 of file Collation.php.

References array(), and wfRunHooks().

Referenced by UppercaseCollation\__construct(), UpdateCollation\execute(), singleton(), and CollationTest\testGetFirstLetter().

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.

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

Reimplemented in IcuCollation, IdentityCollation, and UppercaseCollation.

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

Parameters:
string$stringUTF-8 string
Returns:
string Binary sortkey

Reimplemented in IcuCollation, IdentityCollation, and UppercaseCollation.

static Collation::singleton ( ) [static]
Returns:
Collation

Definition at line 29 of file Collation.php.

References $instance, factory(), and global.

Referenced by UpdateCollation\execute(), Title\moveTo(), and ApiQueryCategoryMembers\run().


Member Data Documentation

Collation::$instance [static]

Definition at line 24 of file Collation.php.

Referenced by singleton().


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