Internationalisation code. More...

Inheritance diagram for Language:

[legend]

Collaboration diagram for Language:

[legend]

Public Member Functions
	__construct ()

	__destruct ()
	Reduce memory usage.

	addMagicWordsByLang ( $newWords)
	Add magic words to the extension array.

	alignEnd ()
	Return 'right' or 'left' as appropriate alignment for line-end for this language's text direction.

	alignStart ()
	Return 'left' or 'right' as appropriate alignment for line-start for this language's text direction.

	autoConvertToAllVariants ( $text)
	convert text to all supported variants

	capitalizeAllNouns ()

	caseFold ( $s)
	Return a case-folded representation of $s.

	checkTitleEncoding ( $s)

	commafy ( $number)
	Adds commas to a given number.

	commaList (array $list)
	Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separator message.

	convert ( $text)
	convert text to different variants of a language.

	convertCategoryKey ( $key)

	convertForSearchResult ( $termsArray)

	convertGrammar ( $word, $case)
	Grammatical transformations, needed for inflected languages Invoked by putting {{grammar:case\|word}} in a message.

	convertHtml ( $text, $isTitle=false)
	Perform output conversion on a string, and encode for safe HTML output.

	convertNamespace ( $ns)
	Convert a namespace index to a string in the preferred variant.

	convertPlural ( $count, $forms)
	Plural form transformations, needed for some languages.

	convertTitle ( $title)
	Convert a Title object to a string in the preferred variant.

	date ( $ts, $adj=false, $format=true, $timecorrection=false)

	dateFormat ( $usePrefs=true)
	This is meant to be used by time(), date(), and timeanddate() to get the date preference they're supposed to use, it should be used in all children.

	digitGroupingPattern ()

	digitTransformTable ()

	embedBidi ( $text='')
	Wraps argument with unicode control characters for directionality safety.

	emphasize ( $text)
	Italic is unsuitable for some languages.

	fallback8bitEncoding ()

	findVariantLink (&$link, &$nt, $ignoreOtherCond=false)
	If a language supports multiple variants, it is possible that non-existing link in one variant actually exists in another variant.

	firstChar ( $s)
	Get the first character of a string.

	fixVariableInNamespace ( $talk)

	formatBitrate ( $bps)
	Format a bitrate for output, using an appropriate unit (bps, kbps, Mbps, Gbps, Tbps, Pbps, Ebps, Zbps or Ybps) according to the magnitude in question.

	formatComputingNumbers ( $size, $boundary, $messageKey)

	formatDuration ( $seconds, array $chosenIntervals=[])
	Takes a number of seconds and turns it into a text using values such as hours and minutes.

	formatExpiry ( $expiry, $format=true, $infinity='infinity')
	Decode an expiry (block, protection, etc) which has come from the DB.

	formatNum ( $number, $nocommafy=false)
	Normally we output all numbers in plain en_US style, that is 293,291.235 for twohundredninetythreethousand-twohundredninetyone point twohundredthirtyfive.

	formatNumNoSeparators ( $number)
	Front-end for non-commafied formatNum.

	formatSize ( $size)
	Format a size in bytes for output, using an appropriate unit (B, KB, MB, GB, TB, PB, EB, ZB or YB) according to the magnitude in question.

	formatTimePeriod ( $seconds, $format=[])

	gender ( $gender, $forms)
	Provides an alternative text depending on specified gender.

	getAllMessages ()

	getArrow ( $direction='forwards')
	An arrow, depending on the language direction.

	getBookstoreList ()
	Exports $wgBookstoreListEn.

	getCode ()
	Get the internal language code for this language object.

	getCompiledPluralRules ()
	Get the compiled plural rules for the language.

	getConverter ()
	Return the LanguageConverter used in the Language.

	getConvRuleTitle ()
	Get the conversion rule title, if any.

	getDateFormats ()

	getDateFormatString ( $type, $pref)
	Get a format string for a given type and preference.

	getDatePreferenceMigrationMap ()

	getDatePreferences ()

	getDefaultDateFormat ()

	getDefaultVariant ()

	getDir ()
	Return the correct HTML 'dir' attribute value for this language.

	getDirMark ( $opposite=false)
	A hidden direction mark (LRM or RLM), depending on the language direction.

	getDirMarkEntity ( $opposite=false)
	A hidden direction mark (LRM or RLM), depending on the language direction.

	getDurationIntervals ( $seconds, array $chosenIntervals=[])
	Takes a number of seconds and returns an array with a set of corresponding intervals.

	getExtraHashOptions ()
	returns language specific options used by User::getPageRenderHash() for example, the preferred language variant

	getExtraUserToggles ()

	getFallbackLanguages ()

	getFormattedNamespaces ()
	A convenience function that returns getNamespaces() with spaces instead of underscores in values.

	getFormattedNsText ( $index)
	A convenience function that returns the same thing as getNsText() except with '_' changed to ' ', useful for producing output.

	getGenderNsText ( $index, $gender)
	Returns gender-dependent namespace alias if available.

	getGrammarForms ()
	Get the grammar forms for the content language.

	getHebrewCalendarMonthName ( $key)

	getHebrewCalendarMonthNameGen ( $key)

	getHijriCalendarMonthName ( $key)

	getHtmlCode ()
	Get the code in BCP 47 format which we can use inside of html lang="" tags.

	getHumanTimestamp (MWTimestamp $time, MWTimestamp $relativeTo=null, User $user=null)
	Get the timestamp in a human-friendly relative format, e.g., "3 days ago".

	getImageFile ( $image)

	getImageFiles ()

	getIranianCalendarMonthName ( $key)

	getLocalNsIndex ( $text)
	Get a namespace key by value, case insensitive.

	getMagic ( $mw)
	Fill a MagicWord object with data from here.

	getMagicWords ()
	Get all magic words from cache.

	getMessage ( $key)

	getMessageFromDB ( $msg)
	Get a message from the MediaWiki namespace.

	getMonthAbbreviation ( $key)

	getMonthAbbreviationsArray ()

	getMonthName ( $key)

	getMonthNameGen ( $key)

	getMonthNamesArray ()

	getNamespaceAliases ()

	getNamespaceIds ()

	getNamespaces ()
	Returns an array of localised namespaces indexed by their numbers.

	getNsIndex ( $text)
	Get a namespace key by value, case insensitive.

	getNsText ( $index)
	Get a namespace value by key.

	getParentLanguage ()
	Get the "parent" language which has a converter to convert a "compatible" language (in another variant) to this language (eg.

	getParsedTitle ()
	For languages that support multiple variants, the title of an article may be displayed differently in different variants.

	getPluralRuleIndexNumber ( $number)
	Find the index number of the plural rule appropriate for the given number.

	getPluralRules ()
	Get the plural rules for the language.

	getPluralRuleType ( $number)
	Find the plural rule type appropriate for the given number For example, if the language is set to Arabic, getPluralType(5) should return 'few'.

	getPluralRuleTypes ()
	Get the plural rule types for the language.

	getPreferredVariant ()

	getSpecialPageAliases ()
	Get special page names, as an associative array canonical name => array of valid names, including aliases.

	getURLVariant ()

	getUserToggle ( $tog)

	getVariantname ( $code, $usemsg=true)
	short names for language variants used for language conversion links.

	getVariants ()
	Get the list of variants supported by this language see sample implementation in LanguageZh.php.

	getWeekdayAbbreviation ( $key)

	getWeekdayName ( $key)

	hasVariant ( $variant)
	Check if the language has the specific variant.

	hasVariants ()
	Check if this is a language with variants.

	hasWordBreaks ()
	Most writing systems use whitespace to break up words.

	iconv ( $in, $out, $string)

	initContLang ()
	Hook which will be called if this is the content language.

	initEncoding ()

	isMultibyte ( $str)

	isRTL ()
	For right-to-left language support.

	lc ( $str, $first=false)

	lcfirst ( $str)

	linkPrefixCharset ()
	A regular expression character set to match legal word-prefixing characters which should be merged onto a link of the form foo[[bar]].

	linkPrefixExtension ()
	To allow "foo[[bar]]" to extend the link over the whole word "foobar".

	linkTrail ()
	A regular expression to match legal word-trailing characters which should be merged onto a link of the form [[foo]]bar.

	listToText (array $l)
	Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separator message.

	markNoConversion ( $text, $noParse=false)
	Prepare external link text for conversion.

	needsGenderDistinction ()
	Whether this language uses gender-dependent namespace aliases.

	normalize ( $s)
	Convert a UTF-8 string to normal form C.

	normalizeForSearch ( $string)
	Some languages have special punctuation need to be normalized.

	parseFormattedNumber ( $number)

	pipeList (array $list)
	Same as commaList, but separate it with the pipe instead.

	recodeForEdit ( $s)

	recodeInput ( $s)

	replaceGrammarInNamespace ( $m)

	resetNamespaces ()
	Resets all of the namespace caches.

	segmentByWord ( $string)
	Some languages such as Chinese require word segmentation, Specify such segmentation when overridden in derived class.

	segmentForDiff ( $text)
	languages like Chinese need to be segmented in order for the diff to be of any use

	semicolonList (array $list)
	Take a list of strings and build a locale-friendly semicolon-separated list, using the local semicolon-separator message.

	separatorTransformTable ()

	setCode ( $code)

	setNamespaces (array $namespaces)
	Arbitrarily set all of the namespace names at once.

	specialList ( $page, $details, $oppositedm=true)
	Make a list item, used by various special pages.

	sprintfDate ( $format, $ts, DateTimeZone $zone=null, &$ttl=null)
	This is a workalike of PHP's date() function, but with better internationalisation, a reduced set of format characters, and a better escaping format.

	time ( $ts, $adj=false, $format=true, $timecorrection=false)

	timeanddate ( $ts, $adj=false, $format=true, $timecorrection=false)

	transformUsingPairFile ( $file, $string)
	Transform a string using serialized data stored in the given file (which must be in the serialized subdirectory of $IP).

	translateBlockExpiry ( $str, User $user=null)

	truncate ( $string, $length, $ellipsis='...', $adjustLength=true)
	Truncate a string to a specified length in bytes, appending an optional string (e.g.

	truncateHtml ( $text, $length, $ellipsis='...')
	Truncate a string of valid HTML to a specified length in bytes, appending an optional string (e.g.

	uc ( $str, $first=false)
	Convert a string to uppercase.

	ucfirst ( $str)
	Make a string's first character uppercase.

	ucwordbreaks ( $str)
	capitalize words at word breaks

	ucwordbreaksCallbackAscii ( $matches)

	ucwordbreaksCallbackMB ( $matches)

	ucwords ( $str)

	ucwordsCallbackMB ( $matches)

	unsegmentForDiff ( $text)
	and unsegment to show the result

	updateConversionTable (Title $title)
	Refresh the cache of conversion tables when MediaWiki:Conversiontable* is updated.

	userAdjust ( $ts, $tz=false)
	Used by date() and time() to adjust the time output.

	userDate ( $ts, User $user, array $options=[])
	Get the formatted date for the given timestamp and formatted for the given user.

	userTime ( $ts, User $user, array $options=[])
	Get the formatted time for the given timestamp and formatted for the given user.

	userTimeAndDate ( $ts, User $user, array $options=[])
	Get the formatted date and time for the given timestamp and formatted for the given user.

	viewPrevNext (Title $title, $offset, $limit, array $query=[], $atend=false)
	Generate (prev x\| next x) (20\|50\|100...) type links for paging.

Static Public Member Functions
static	classFromCode ( $code)

static	factory ( $code)
	Get a cached or new language object for a given language code.

static	fetchLanguageName ( $code, $inLanguage=null, $include='all')

static	fetchLanguageNames ( $inLanguage=null, $include='mw')
	Get an array of language names, indexed by code.

static	getCodeFromFileName ( $filename, $prefix='Language', $suffix='.php')
	Get the language code from a file name.

static	getFallbackFor ( $code)
	Get the first fallback for a given language.

static	getFallbacksFor ( $code)
	Get the ordered list of fallback languages.

static	getFallbacksIncludingSiteLanguage ( $code)
	Get the ordered list of fallback languages, ending with the fallback language chain for the site language.

static	getFileName ( $prefix='Language', $code, $suffix='.php')
	Get the name of a file for a certain language code.

static	getJsonMessagesFileName ( $code)

static	getLocalisationCache ()
	Get the LocalisationCache instance.

static	getMessageFor ( $key, $code)
	Get a message for a given language.

static	getMessageKeysFor ( $code)
	Get all message keys for a given language.

static	getMessagesFileName ( $code)

static	getMessagesFor ( $code)
	Get all messages for a given language WARNING: this may take a long time.

static	hebrewNumeral ( $num)
	Hebrew Gematria number formatting up to 9999.

static	isKnownLanguageTag ( $tag)
	Returns true if a language code is an IETF tag known to MediaWiki.

static	isSupportedLanguage ( $code)
	Checks whether any localisation is available for that language tag in MediaWiki (MessagesXx.php exists).

static	isValidBuiltInCode ( $code)
	Returns true if a language code is of a valid form for the purposes of internal customisation of MediaWiki, via Messages.php or .json.

static	isValidCode ( $code)
	Returns true if a language code string is of a valid form, whether or not it exists.

static	isWellFormedLanguageTag ( $code, $lenient=false)
	Returns true if a language code string is a well-formed language tag according to RFC 5646.

static	romanNumeral ( $num)
	Roman number formatting up to 10000.

Public Attributes
	$dateFormatStrings = []

	$mCode

LanguageConverter	$mConverter

	$mExtendedSpecialPageAliases

	$mLoaded = false

	$mMagicExtensions = []

	$mMagicHookDone = false

	$mVariants

	$transformData = []
	ReplacementArray object caches.

Static Public Attributes
static LocalisationCache	$dataCache

static array	$durationIntervals

static	$mHebrewCalendarMonthGenMsgs

static	$mHebrewCalendarMonthMsgs

static	$mHijriCalendarMonthMsgs

static	$mIranianCalendarMonthMsgs

static	$mLangObjCache = []

static	$mMonthAbbrevMsgs

static	$mMonthGenMsgs

static	$mMonthMsgs

static	$mWeekdayAbbrevMsgs

static	$mWeekdayMsgs

Protected Member Functions
	doMagicHook ()
	Run the LanguageGetMagic hook once.

	handleExplicitPluralForms ( $count, array $forms)
	Handles explicit plural forms for Language::convertPlural()

	msg ( $msg)
	Get message object in this language.

	preConvertPlural ($forms, $count)
	Checks that convertPlural was given an array and pads it to requested amount of forms by copying the last one.

	removeBadCharFirst ( $string)
	Remove bytes that represent an incomplete Unicode character at the start of string (e.g.

	removeBadCharLast ( $string)
	Remove bytes that represent an incomplete Unicode character at the end of string (e.g.

Static Protected Member Functions
static	convertDoubleWidth ( $string)
	convert double-width roman characters to single-width.

static	insertSpace ( $string, $pattern)

static	newFromCode ( $code)
	Create a language object for a given language code.

Protected Attributes
	$mNamespaceIds

	$namespaceAliases

	$namespaceNames

Private Member Functions
	getHumanTimestampInternal (MWTimestamp $ts, MWTimestamp $relativeTo, User $user)
	Convert an MWTimestamp into a pretty human-readable timestamp using the given user preferences and relative base time.

	internalUserTimeAndDate ( $type, $ts, User $user, array $options)
	Internal helper function for userDate(), userTime() and userTimeAndDate()

	numLink (Title $title, $offset, $limit, array $query, $link, $tooltipMsg, $class)
	Helper function for viewPrevNext() that generates links.

	truncate_endBracket (&$tag, $tagType, $lastCh, &$openTags)
	truncateHtml() helper function (a) push or pop $tag from $openTags as needed (b) clear $tag value

	truncate_skip (&$ret, $text, $search, $start, $len=null)
	truncateHtml() helper function like strcspn() but adds the skipped chars to $ret

Static Private Member Functions
static	dateTimeObjFormat (&$dateTimeObj, $ts, $zone, $code)
	Pass through result from $dateTimeObj->format()

static	fetchLanguageNamesUncached ( $inLanguage=null, $include='mw')
	Uncached helper for fetchLanguageNames.

static	hebrewYearStart ( $year)
	This calculates the Hebrew year start, as days since 1 September.

static	strongDirFromContent ( $text='')
	Gets directionality of the first strongly directional codepoint, for embedBidi()

static	tsToHebrew ( $ts)
	Converting Gregorian dates to Hebrew dates.

static	tsToHijri ( $ts)
	Converting Gregorian dates to Hijri dates.

static	tsToIranian ( $ts)
	Algorithm by Roozbeh Pournader and Mohammad Toossi to convert Gregorian dates to Iranian dates.

static	tsToYear ( $ts, $cName)
	Algorithm to convert Gregorian dates to Thai solar dates, Minguo dates or Minguo dates.

Private Attributes
	$mHtmlCode = null

	$mParentLanguage = false

Static Private Attributes
static array	$fallbackLanguageCache = []
	Cache for language fallbacks.

static	$GREG_DAYS = [ 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 ]

static	$IRANIAN_DAYS = [ 31, 31, 31, 31, 31, 31, 30, 30, 30, 30, 30, 29 ]

static HashBagOStuff null	$languageNameCache
	Cache for language names.

static	$lre = "\xE2\x80\xAA"
	Unicode directional formatting characters, for embedBidi()

static	$pdf = "\xE2\x80\xAC"

static	$rle = "\xE2\x80\xAB"

static	$strongDirRegex = '/(?:([\x{41}-\x{5a}\x{61}-\x{7a}\x{aa}\x{b5}\x{ba}\x{c0}-\x{d6}\x{d8}-\x{f6}\x{f8}-\x{2b8}\x{2bb}-\x{2c1}\x{2d0}\x{2d1}\x{2e0}-\x{2e4}\x{2ee}\x{370}-\x{373}\x{376}\x{377}\x{37a}-\x{37d}\x{37f}\x{386}\x{388}-\x{38a}\x{38c}\x{38e}-\x{3a1}\x{3a3}-\x{3f5}\x{3f7}-\x{482}\x{48a}-\x{52f}\x{531}-\x{556}\x{559}-\x{55f}\x{561}-\x{587}\x{589}\x{903}-\x{939}\x{93b}\x{93d}-\x{940}\x{949}-\x{94c}\x{94e}-\x{950}\x{958}-\x{961}\x{964}-\x{980}\x{982}\x{983}\x{985}-\x{98c}\x{98f}\x{990}\x{993}-\x{9a8}\x{9aa}-\x{9b0}\x{9b2}\x{9b6}-\x{9b9}\x{9bd}-\x{9c0}\x{9c7}\x{9c8}\x{9cb}\x{9cc}\x{9ce}\x{9d7}\x{9dc}\x{9dd}\x{9df}-\x{9e1}\x{9e6}-\x{9f1}\x{9f4}-\x{9fa}\x{a03}\x{a05}-\x{a0a}\x{a0f}\x{a10}\x{a13}-\x{a28}\x{a2a}-\x{a30}\x{a32}\x{a33}\x{a35}\x{a36}\x{a38}\x{a39}\x{a3e}-\x{a40}\x{a59}-\x{a5c}\x{a5e}\x{a66}-\x{a6f}\x{a72}-\x{a74}\x{a83}\x{a85}-\x{a8d}\x{a8f}-\x{a91}\x{a93}-\x{aa8}\x{aaa}-\x{ab0}\x{ab2}\x{ab3}\x{ab5}-\x{ab9}\x{abd}-\x{ac0}\x{ac9}\x{acb}\x{acc}\x{ad0}\x{ae0}\x{ae1}\x{ae6}-\x{af0}\x{af9}\x{b02}\x{b03}\x{b05}-\x{b0c}\x{b0f}\x{b10}\x{b13}-\x{b28}\x{b2a}-\x{b30}\x{b32}\x{b33}\x{b35}-\x{b39}\x{b3d}\x{b3e}\x{b40}\x{b47}\x{b48}\x{b4b}\x{b4c}\x{b57}\x{b5c}\x{b5d}\x{b5f}-\x{b61}\x{b66}-\x{b77}\x{b83}\x{b85}-\x{b8a}\x{b8e}-\x{b90}\x{b92}-\x{b95}\x{b99}\x{b9a}\x{b9c}\x{b9e}\x{b9f}\x{ba3}\x{ba4}\x{ba8}-\x{baa}\x{bae}-\x{bb9}\x{bbe}\x{bbf}\x{bc1}\x{bc2}\x{bc6}-\x{bc8}\x{bca}-\x{bcc}\x{bd0}\x{bd7}\x{be6}-\x{bf2}\x{c01}-\x{c03}\x{c05}-\x{c0c}\x{c0e}-\x{c10}\x{c12}-\x{c28}\x{c2a}-\x{c39}\x{c3d}\x{c41}-\x{c44}\x{c58}-\x{c5a}\x{c60}\x{c61}\x{c66}-\x{c6f}\x{c7f}\x{c82}\x{c83}\x{c85}-\x{c8c}\x{c8e}-\x{c90}\x{c92}-\x{ca8}\x{caa}-\x{cb3}\x{cb5}-\x{cb9}\x{cbd}-\x{cc4}\x{cc6}-\x{cc8}\x{cca}\x{ccb}\x{cd5}\x{cd6}\x{cde}\x{ce0}\x{ce1}\x{ce6}-\x{cef}\x{cf1}\x{cf2}\x{d02}\x{d03}\x{d05}-\x{d0c}\x{d0e}-\x{d10}\x{d12}-\x{d3a}\x{d3d}-\x{d40}\x{d46}-\x{d48}\x{d4a}-\x{d4c}\x{d4e}\x{d57}\x{d5f}-\x{d61}\x{d66}-\x{d75}\x{d79}-\x{d7f}\x{d82}\x{d83}\x{d85}-\x{d96}\x{d9a}-\x{db1}\x{db3}-\x{dbb}\x{dbd}\x{dc0}-\x{dc6}\x{dcf}-\x{dd1}\x{dd8}-\x{ddf}\x{de6}-\x{def}\x{df2}-\x{df4}\x{e01}-\x{e30}\x{e32}\x{e33}\x{e40}-\x{e46}\x{e4f}-\x{e5b}\x{e81}\x{e82}\x{e84}\x{e87}\x{e88}\x{e8a}\x{e8d}\x{e94}-\x{e97}\x{e99}-\x{e9f}\x{ea1}-\x{ea3}\x{ea5}\x{ea7}\x{eaa}\x{eab}\x{ead}-\x{eb0}\x{eb2}\x{eb3}\x{ebd}\x{ec0}-\x{ec4}\x{ec6}\x{ed0}-\x{ed9}\x{edc}-\x{edf}\x{f00}-\x{f17}\x{f1a}-\x{f34}\x{f36}\x{f38}\x{f3e}-\x{f47}\x{f49}-\x{f6c}\x{f7f}\x{f85}\x{f88}-\x{f8c}\x{fbe}-\x{fc5}\x{fc7}-\x{fcc}\x{fce}-\x{fda}\x{1000}-\x{102c}\x{1031}\x{1038}\x{103b}\x{103c}\x{103f}-\x{1057}\x{105a}-\x{105d}\x{1061}-\x{1070}\x{1075}-\x{1081}\x{1083}\x{1084}\x{1087}-\x{108c}\x{108e}-\x{109c}\x{109e}-\x{10c5}\x{10c7}\x{10cd}\x{10d0}-\x{1248}\x{124a}-\x{124d}\x{1250}-\x{1256}\x{1258}\x{125a}-\x{125d}\x{1260}-\x{1288}\x{128a}-\x{128d}\x{1290}-\x{12b0}\x{12b2}-\x{12b5}\x{12b8}-\x{12be}\x{12c0}\x{12c2}-\x{12c5}\x{12c8}-\x{12d6}\x{12d8}-\x{1310}\x{1312}-\x{1315}\x{1318}-\x{135a}\x{1360}-\x{137c}\x{1380}-\x{138f}\x{13a0}-\x{13f5}\x{13f8}-\x{13fd}\x{1401}-\x{167f}\x{1681}-\x{169a}\x{16a0}-\x{16f8}\x{1700}-\x{170c}\x{170e}-\x{1711}\x{1720}-\x{1731}\x{1735}\x{1736}\x{1740}-\x{1751}\x{1760}-\x{176c}\x{176e}-\x{1770}\x{1780}-\x{17b3}\x{17b6}\x{17be}-\x{17c5}\x{17c7}\x{17c8}\x{17d4}-\x{17da}\x{17dc}\x{17e0}-\x{17e9}\x{1810}-\x{1819}\x{1820}-\x{1877}\x{1880}-\x{18a8}\x{18aa}\x{18b0}-\x{18f5}\x{1900}-\x{191e}\x{1923}-\x{1926}\x{1929}-\x{192b}\x{1930}\x{1931}\x{1933}-\x{1938}\x{1946}-\x{196d}\x{1970}-\x{1974}\x{1980}-\x{19ab}\x{19b0}-\x{19c9}\x{19d0}-\x{19da}\x{1a00}-\x{1a16}\x{1a19}\x{1a1a}\x{1a1e}-\x{1a55}\x{1a57}\x{1a61}\x{1a63}\x{1a64}\x{1a6d}-\x{1a72}\x{1a80}-\x{1a89}\x{1a90}-\x{1a99}\x{1aa0}-\x{1aad}\x{1b04}-\x{1b33}\x{1b35}\x{1b3b}\x{1b3d}-\x{1b41}\x{1b43}-\x{1b4b}\x{1b50}-\x{1b6a}\x{1b74}-\x{1b7c}\x{1b82}-\x{1ba1}\x{1ba6}\x{1ba7}\x{1baa}\x{1bae}-\x{1be5}\x{1be7}\x{1bea}-\x{1bec}\x{1bee}\x{1bf2}\x{1bf3}\x{1bfc}-\x{1c2b}\x{1c34}\x{1c35}\x{1c3b}-\x{1c49}\x{1c4d}-\x{1c7f}\x{1cc0}-\x{1cc7}\x{1cd3}\x{1ce1}\x{1ce9}-\x{1cec}\x{1cee}-\x{1cf3}\x{1cf5}\x{1cf6}\x{1d00}-\x{1dbf}\x{1e00}-\x{1f15}\x{1f18}-\x{1f1d}\x{1f20}-\x{1f45}\x{1f48}-\x{1f4d}\x{1f50}-\x{1f57}\x{1f59}\x{1f5b}\x{1f5d}\x{1f5f}-\x{1f7d}\x{1f80}-\x{1fb4}\x{1fb6}-\x{1fbc}\x{1fbe}\x{1fc2}-\x{1fc4}\x{1fc6}-\x{1fcc}\x{1fd0}-\x{1fd3}\x{1fd6}-\x{1fdb}\x{1fe0}-\x{1fec}\x{1ff2}-\x{1ff4}\x{1ff6}-\x{1ffc}\x{200e}\x{2071}\x{207f}\x{2090}-\x{209c}\x{2102}\x{2107}\x{210a}-\x{2113}\x{2115}\x{2119}-\x{211d}\x{2124}\x{2126}\x{2128}\x{212a}-\x{212d}\x{212f}-\x{2139}\x{213c}-\x{213f}\x{2145}-\x{2149}\x{214e}\x{214f}\x{2160}-\x{2188}\x{2336}-\x{237a}\x{2395}\x{249c}-\x{24e9}\x{26ac}\x{2800}-\x{28ff}\x{2c00}-\x{2c2e}\x{2c30}-\x{2c5e}\x{2c60}-\x{2ce4}\x{2ceb}-\x{2cee}\x{2cf2}\x{2cf3}\x{2d00}-\x{2d25}\x{2d27}\x{2d2d}\x{2d30}-\x{2d67}\x{2d6f}\x{2d70}\x{2d80}-\x{2d96}\x{2da0}-\x{2da6}\x{2da8}-\x{2dae}\x{2db0}-\x{2db6}\x{2db8}-\x{2dbe}\x{2dc0}-\x{2dc6}\x{2dc8}-\x{2dce}\x{2dd0}-\x{2dd6}\x{2dd8}-\x{2dde}\x{3005}-\x{3007}\x{3021}-\x{3029}\x{302e}\x{302f}\x{3031}-\x{3035}\x{3038}-\x{303c}\x{3041}-\x{3096}\x{309d}-\x{309f}\x{30a1}-\x{30fa}\x{30fc}-\x{30ff}\x{3105}-\x{312d}\x{3131}-\x{318e}\x{3190}-\x{31ba}\x{31f0}-\x{321c}\x{3220}-\x{324f}\x{3260}-\x{327b}\x{327f}-\x{32b0}\x{32c0}-\x{32cb}\x{32d0}-\x{32fe}\x{3300}-\x{3376}\x{337b}-\x{33dd}\x{33e0}-\x{33fe}\x{3400}-\x{4db5}\x{4e00}-\x{9fd5}\x{a000}-\x{a48c}\x{a4d0}-\x{a60c}\x{a610}-\x{a62b}\x{a640}-\x{a66e}\x{a680}-\x{a69d}\x{a6a0}-\x{a6ef}\x{a6f2}-\x{a6f7}\x{a722}-\x{a787}\x{a789}-\x{a7ad}\x{a7b0}-\x{a7b7}\x{a7f7}-\x{a801}\x{a803}-\x{a805}\x{a807}-\x{a80a}\x{a80c}-\x{a824}\x{a827}\x{a830}-\x{a837}\x{a840}-\x{a873}\x{a880}-\x{a8c3}\x{a8ce}-\x{a8d9}\x{a8f2}-\x{a8fd}\x{a900}-\x{a925}\x{a92e}-\x{a946}\x{a952}\x{a953}\x{a95f}-\x{a97c}\x{a983}-\x{a9b2}\x{a9b4}\x{a9b5}\x{a9ba}\x{a9bb}\x{a9bd}-\x{a9cd}\x{a9cf}-\x{a9d9}\x{a9de}-\x{a9e4}\x{a9e6}-\x{a9fe}\x{aa00}-\x{aa28}\x{aa2f}\x{aa30}\x{aa33}\x{aa34}\x{aa40}-\x{aa42}\x{aa44}-\x{aa4b}\x{aa4d}\x{aa50}-\x{aa59}\x{aa5c}-\x{aa7b}\x{aa7d}-\x{aaaf}\x{aab1}\x{aab5}\x{aab6}\x{aab9}-\x{aabd}\x{aac0}\x{aac2}\x{aadb}-\x{aaeb}\x{aaee}-\x{aaf5}\x{ab01}-\x{ab06}\x{ab09}-\x{ab0e}\x{ab11}-\x{ab16}\x{ab20}-\x{ab26}\x{ab28}-\x{ab2e}\x{ab30}-\x{ab65}\x{ab70}-\x{abe4}\x{abe6}\x{abe7}\x{abe9}-\x{abec}\x{abf0}-\x{abf9}\x{ac00}-\x{d7a3}\x{d7b0}-\x{d7c6}\x{d7cb}-\x{d7fb}\x{e000}-\x{fa6d}\x{fa70}-\x{fad9}\x{fb00}-\x{fb06}\x{fb13}-\x{fb17}\x{ff21}-\x{ff3a}\x{ff41}-\x{ff5a}\x{ff66}-\x{ffbe}\x{ffc2}-\x{ffc7}\x{ffca}-\x{ffcf}\x{ffd2}-\x{ffd7}\x{ffda}-\x{ffdc}\x{10000}-\x{1000b}\x{1000d}-\x{10026}\x{10028}-\x{1003a}\x{1003c}\x{1003d}\x{1003f}-\x{1004d}\x{10050}-\x{1005d}\x{10080}-\x{100fa}\x{10100}\x{10102}\x{10107}-\x{10133}\x{10137}-\x{1013f}\x{101d0}-\x{101fc}\x{10280}-\x{1029c}\x{102a0}-\x{102d0}\x{10300}-\x{10323}\x{10330}-\x{1034a}\x{10350}-\x{10375}\x{10380}-\x{1039d}\x{1039f}-\x{103c3}\x{103c8}-\x{103d5}\x{10400}-\x{1049d}\x{104a0}-\x{104a9}\x{10500}-\x{10527}\x{10530}-\x{10563}\x{1056f}\x{10600}-\x{10736}\x{10740}-\x{10755}\x{10760}-\x{10767}\x{11000}\x{11002}-\x{11037}\x{11047}-\x{1104d}\x{11066}-\x{1106f}\x{11082}-\x{110b2}\x{110b7}\x{110b8}\x{110bb}-\x{110c1}\x{110d0}-\x{110e8}\x{110f0}-\x{110f9}\x{11103}-\x{11126}\x{1112c}\x{11136}-\x{11143}\x{11150}-\x{11172}\x{11174}-\x{11176}\x{11182}-\x{111b5}\x{111bf}-\x{111c9}\x{111cd}\x{111d0}-\x{111df}\x{111e1}-\x{111f4}\x{11200}-\x{11211}\x{11213}-\x{1122e}\x{11232}\x{11233}\x{11235}\x{11238}-\x{1123d}\x{11280}-\x{11286}\x{11288}\x{1128a}-\x{1128d}\x{1128f}-\x{1129d}\x{1129f}-\x{112a9}\x{112b0}-\x{112de}\x{112e0}-\x{112e2}\x{112f0}-\x{112f9}\x{11302}\x{11303}\x{11305}-\x{1130c}\x{1130f}\x{11310}\x{11313}-\x{11328}\x{1132a}-\x{11330}\x{11332}\x{11333}\x{11335}-\x{11339}\x{1133d}-\x{1133f}\x{11341}-\x{11344}\x{11347}\x{11348}\x{1134b}-\x{1134d}\x{11350}\x{11357}\x{1135d}-\x{11363}\x{11480}-\x{114b2}\x{114b9}\x{114bb}-\x{114be}\x{114c1}\x{114c4}-\x{114c7}\x{114d0}-\x{114d9}\x{11580}-\x{115b1}\x{115b8}-\x{115bb}\x{115be}\x{115c1}-\x{115db}\x{11600}-\x{11632}\x{1163b}\x{1163c}\x{1163e}\x{11641}-\x{11644}\x{11650}-\x{11659}\x{11680}-\x{116aa}\x{116ac}\x{116ae}\x{116af}\x{116b6}\x{116c0}-\x{116c9}\x{11700}-\x{11719}\x{11720}\x{11721}\x{11726}\x{11730}-\x{1173f}\x{118a0}-\x{118f2}\x{118ff}\x{11ac0}-\x{11af8}\x{12000}-\x{12399}\x{12400}-\x{1246e}\x{12470}-\x{12474}\x{12480}-\x{12543}\x{13000}-\x{1342e}\x{14400}-\x{14646}\x{16800}-\x{16a38}\x{16a40}-\x{16a5e}\x{16a60}-\x{16a69}\x{16a6e}\x{16a6f}\x{16ad0}-\x{16aed}\x{16af5}\x{16b00}-\x{16b2f}\x{16b37}-\x{16b45}\x{16b50}-\x{16b59}\x{16b5b}-\x{16b61}\x{16b63}-\x{16b77}\x{16b7d}-\x{16b8f}\x{16f00}-\x{16f44}\x{16f50}-\x{16f7e}\x{16f93}-\x{16f9f}\x{1b000}\x{1b001}\x{1bc00}-\x{1bc6a}\x{1bc70}-\x{1bc7c}\x{1bc80}-\x{1bc88}\x{1bc90}-\x{1bc99}\x{1bc9c}\x{1bc9f}\x{1d000}-\x{1d0f5}\x{1d100}-\x{1d126}\x{1d129}-\x{1d166}\x{1d16a}-\x{1d172}\x{1d183}\x{1d184}\x{1d18c}-\x{1d1a9}\x{1d1ae}-\x{1d1e8}\x{1d360}-\x{1d371}\x{1d400}-\x{1d454}\x{1d456}-\x{1d49c}\x{1d49e}\x{1d49f}\x{1d4a2}\x{1d4a5}\x{1d4a6}\x{1d4a9}-\x{1d4ac}\x{1d4ae}-\x{1d4b9}\x{1d4bb}\x{1d4bd}-\x{1d4c3}\x{1d4c5}-\x{1d505}\x{1d507}-\x{1d50a}\x{1d50d}-\x{1d514}\x{1d516}-\x{1d51c}\x{1d51e}-\x{1d539}\x{1d53b}-\x{1d53e}\x{1d540}-\x{1d544}\x{1d546}\x{1d54a}-\x{1d550}\x{1d552}-\x{1d6a5}\x{1d6a8}-\x{1d6da}\x{1d6dc}-\x{1d714}\x{1d716}-\x{1d74e}\x{1d750}-\x{1d788}\x{1d78a}-\x{1d7c2}\x{1d7c4}-\x{1d7cb}\x{1d800}-\x{1d9ff}\x{1da37}-\x{1da3a}\x{1da6d}-\x{1da74}\x{1da76}-\x{1da83}\x{1da85}-\x{1da8b}\x{1f110}-\x{1f12e}\x{1f130}-\x{1f169}\x{1f170}-\x{1f19a}\x{1f1e6}-\x{1f202}\x{1f210}-\x{1f23a}\x{1f240}-\x{1f248}\x{1f250}\x{1f251}\x{20000}-\x{2a6d6}\x{2a700}-\x{2b734}\x{2b740}-\x{2b81d}\x{2b820}-\x{2cea1}\x{2f800}-\x{2fa1d}\x{f0000}-\x{ffffd}\x{100000}-\x{10fffd}])\|([\x{590}\x{5be}\x{5c0}\x{5c3}\x{5c6}\x{5c8}-\x{5ff}\x{7c0}-\x{7ea}\x{7f4}\x{7f5}\x{7fa}-\x{815}\x{81a}\x{824}\x{828}\x{82e}-\x{858}\x{85c}-\x{89f}\x{200f}\x{fb1d}\x{fb1f}-\x{fb28}\x{fb2a}-\x{fb4f}\x{10800}-\x{1091e}\x{10920}-\x{10a00}\x{10a04}\x{10a07}-\x{10a0b}\x{10a10}-\x{10a37}\x{10a3b}-\x{10a3e}\x{10a40}-\x{10ae4}\x{10ae7}-\x{10b38}\x{10b40}-\x{10e5f}\x{10e7f}-\x{10fff}\x{1e800}-\x{1e8cf}\x{1e8d7}-\x{1edff}\x{1ef00}-\x{1efff}\x{608}\x{60b}\x{60d}\x{61b}-\x{64a}\x{66d}-\x{66f}\x{671}-\x{6d5}\x{6e5}\x{6e6}\x{6ee}\x{6ef}\x{6fa}-\x{710}\x{712}-\x{72f}\x{74b}-\x{7a5}\x{7b1}-\x{7bf}\x{8a0}-\x{8e2}\x{fb50}-\x{fd3d}\x{fd40}-\x{fdcf}\x{fdf0}-\x{fdfc}\x{fdfe}\x{fdff}\x{fe70}-\x{fefe}\x{1ee00}-\x{1eeef}\x{1eef2}-\x{1eeff}]))/u'
	Directionality test regex for embedBidi().

Detailed Description

Internationalisation code.

Examples: /src/tests/phpunit/MediaWikiTestCase.php.

Definition at line 39 of file Language.php.

Constructor & Destructor Documentation

◆ __construct()

Language::__construct ( )

Reimplemented in LanguageGan, LanguageIu, LanguageKk, LanguageKu, LanguageShi, LanguageSr, LanguageTg, LanguageUz, LanguageZh, and LanguageToTest.

Definition at line 411 of file Language.php.

◆ __destruct()

Language::__destruct ( )

Reduce memory usage.

Definition at line 425 of file Language.php.

References $name, $value, and as.

Member Function Documentation

◆ addMagicWordsByLang()

Language::addMagicWordsByLang ( $newWords )

Add magic words to the extension array.

Parameters

array $newWords

Definition at line 3199 of file Language.php.

References $code, as, and getFallbackLanguages().

◆ alignEnd()

Language::alignEnd ( )

Return 'right' or 'left' as appropriate alignment for line-end for this language's text direction.

Should be equivalent to CSS3 'end' text-align value....

Returns: string

Definition at line 3068 of file Language.php.

References isRTL().

◆ alignStart()

Language::alignStart ( )

Return 'left' or 'right' as appropriate alignment for line-start for this language's text direction.

Should be equivalent to CSS3 'start' text-align value....

Returns: string

Definition at line 3056 of file Language.php.

References isRTL().

◆ autoConvertToAllVariants()

Language::autoConvertToAllVariants ( $text )

convert text to all supported variants

Parameters

string $text

Returns: array

Definition at line 3984 of file Language.php.

◆ capitalizeAllNouns()

Language::capitalizeAllNouns ( )

Returns: array

Definition at line 3112 of file Language.php.

◆ caseFold()

Language::caseFold ( $s )

Return a case-folded representation of $s.

This is a representation such that caseFold($s1)==caseFold($s2) if $s1 and $s2 are the same except for the case of their characters. It is not necessary for the value returned to make sense when displayed.

Do not perform any other normalisation in this function. If a caller uses this function when it should be using a more general normalisation function, then fix the caller.

Parameters

string $s

Returns: string

Definition at line 2779 of file Language.php.

References $s, and uc().

◆ checkTitleEncoding()

Language::checkTitleEncoding ( $s )

Parameters

string $s

Returns: string

Exceptions

MWException

Definition at line 2788 of file Language.php.

References $s, fallback8bitEncoding(), iconv(), and StringUtils\isUtf8().

◆ classFromCode()

static Language::classFromCode ( $code )

static

Parameters

string $code

Returns: string Name of the language class

Definition at line 4263 of file Language.php.

References $code, and ucfirst().

◆ commafy()

Language::commafy ( $number )

Adds commas to a given number.

Since: 1.19

Parameters

mixed $number

Returns: string

Reimplemented in LanguageBe_tarask, LanguageBg, LanguageEs, LanguageEt, LanguageHy, LanguageKaa, LanguageKk_cyrl, LanguageKm, LanguageKsh, LanguageKu_ku, LanguageMy, LanguagePl, LanguageRu, and LanguageUk.

Definition at line 3320 of file Language.php.

References $digitGroupingPattern, $matches, and digitGroupingPattern().

Referenced by formatNum().

◆ commaList()

Language::commaList ( array $list )

Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separator message.

Parameters

string[] $list Array of strings to put in a comma list

Returns: string

Definition at line 3428 of file Language.php.

References wfMessage().

◆ convert()

Language::convert ( $text )

convert text to different variants of a language.

Parameters

string $text

Returns: string

Definition at line 3994 of file Language.php.

Referenced by convertHtml().

◆ convertCategoryKey()

Language::convertCategoryKey ( $key )

Parameters

string $key

Returns: string

Definition at line 4053 of file Language.php.

◆ convertDoubleWidth()

static Language::convertDoubleWidth ( $string )

staticprotected

convert double-width roman characters to single-width.

range: ff00-ff5f ~= 0020-007f

Parameters

string $string

Returns: string

Definition at line 2848 of file Language.php.

Referenced by LanguageZh\convertForSearchResult(), and LanguageYue\normalizeForSearch().

◆ convertForSearchResult()

Language::convertForSearchResult ( $termsArray )

Parameters

array $termsArray

Returns: array

Reimplemented in LanguageZh.

Definition at line 2878 of file Language.php.

◆ convertGrammar()

Language::convertGrammar	(	$word,
		$case
	)

Grammatical transformations, needed for inflected languages Invoked by putting {{grammar:case|word}} in a message.

Parameters

string	$word
string	$case

Returns: string

Reimplemented in LanguageBs, LanguageCu, LanguageDsb, LanguageFi, LanguageGa, LanguageHe, LanguageHsb, LanguageHu, LanguageHy, LanguageKaa, LanguageKk, LanguageKsh, LanguageLa, LanguageOs, LanguageRu, LanguageSl, LanguageTyv, and LanguageUk.

Definition at line 3741 of file Language.php.

References $wgGrammarForms, getCode(), and global.

Referenced by replaceGrammarInNamespace().

◆ convertHtml()

Language::convertHtml	(	$text,
		$isTitle = `false`
	)

Perform output conversion on a string, and encode for safe HTML output.

Parameters

string	$text	Text to be converted
bool	$isTitle	Whether this conversion is for the article title

Returns: string

Todo:: this should get integrated somewhere sane

Definition at line 4045 of file Language.php.

References convert().

◆ convertNamespace()

Language::convertNamespace ( $ns )

Convert a namespace index to a string in the preferred variant.

Parameters

int $ns

Returns: string

Definition at line 4014 of file Language.php.

◆ convertPlural()

Language::convertPlural	(	$count,
		$forms
	)

Plural form transformations, needed for some languages.

For example, there are 3 form of plural in Russian and Polish, depending on "count mod 10". See [[w:Plural]] For English it is pretty simple.

Invoked by putting {{plural:count|wordform1|wordform2}} or {{plural:count|wordform1|wordform2|wordform3}}

Example: {{plural:{{NUMBEROFARTICLES}}|article|articles}}

Parameters

int	$count	Non-localized number
array	$forms	Different plural forms

Returns: string Correct form of plural for $count in this language

Reimplemented in LanguageKsh.

Definition at line 3812 of file Language.php.

References $count, getPluralRuleIndexNumber(), and handleExplicitPluralForms().

◆ convertTitle()

Language::convertTitle ( $title )

Convert a Title object to a string in the preferred variant.

Parameters

Title $title

Returns: string

Definition at line 4004 of file Language.php.

References $title.

◆ date()

Language::date	(	$ts,
		$adj = `false`,
		$format = `true`,
		$timecorrection = `false`
	)

Parameters

string	$ts	The time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts)
bool	$adj	Whether to adjust the time output according to the user configured offset ($timecorrection)
mixed	$format	True to use user's date format preference
string \| bool	$timecorrection	The time offset as returned by validateTimeZone() in Special:Preferences

Returns: string

Reimplemented in LanguageWa.

Definition at line 2227 of file Language.php.

References dateFormat(), getDateFormatString(), sprintfDate(), TS_MW, userAdjust(), and wfTimestamp().

Referenced by LanguageFi\translateBlockExpiry(), and userAdjust().

◆ dateFormat()

Language::dateFormat ( $usePrefs = true )

This is meant to be used by time(), date(), and timeanddate() to get the date preference they're supposed to use, it should be used in all children.

function timeanddate([...], $format = true) { $datePreference = $this->dateFormat($format); [...] }

Parameters

int | string | bool $usePrefs If true, the user's preference is used if false, the site/language default is used if int/string, assumed to be a format.

Returns: string

Definition at line 2162 of file Language.php.

References $wgUser, global, and string.

Referenced by LanguageWa\date(), date(), internalUserTimeAndDate(), time(), LanguageWa\timeanddate(), and timeanddate().

◆ dateTimeObjFormat()

static Language::dateTimeObjFormat	(	&	$dateTimeObj,
			$ts,
			$zone,
			$code
	)

staticprivate

Pass through result from $dateTimeObj->format()

Parameters

DateTime \| bool \| null	&$dateTimeObj
string	$ts
DateTimeZone \| bool \| null	$zone
string	$code

Returns: string

Definition at line 1014 of file Language.php.

References $code.

Referenced by sprintfDate().

◆ digitGroupingPattern()

Language::digitGroupingPattern ( )

Returns: string

Definition at line 3372 of file Language.php.

Referenced by commafy().

◆ digitTransformTable()

Language::digitTransformTable ( )

Returns: array

Definition at line 3379 of file Language.php.

Referenced by formatNum(), and parseFormattedNumber().

◆ doMagicHook()

Language::doMagicHook ( )

protected

Run the LanguageGetMagic hook once.

Definition at line 3160 of file Language.php.

References getCode().

Referenced by getMagic().

◆ embedBidi()

Language::embedBidi ( $text = '' )

Wraps argument with unicode control characters for directionality safety.

This solves the problem where directionality-neutral characters at the edge of the argument string get interpreted with the wrong directionality from the enclosing context, giving renderings that look corrupted like "(Ben_(WMF".

The wrapping is LRE...PDF or RLE...PDF, depending on the detected directionality of the argument string, using the BIDI algorithm's own "First strong directional codepoint" rule. Essentially, this works round the fact that there is no embedding equivalent of U+2068 FSI (isolation with heuristic direction inference). The latter is cleaner but still not widely supported.

Parameters

string $text Text to wrap

Returns: string Text, wrapped in LRE...PDF or RLE...PDF or nothing

Definition at line 3886 of file Language.php.

References $dir, and strongDirFromContent().

◆ emphasize()

Language::emphasize ( $text )

Italic is unsuitable for some languages.

Parameters

string $text The text to be emphasized.

Returns: string

Reimplemented in LanguageJa.

Definition at line 3233 of file Language.php.

◆ factory()

static Language::factory ( $code )

static

Get a cached or new language object for a given language code.

Parameters

string $code

Returns: Language

Definition at line 179 of file Language.php.

References $code, $wgDummyLanguageCodes, $wgLangObjCacheSize, and global.

Referenced by getParentLanguage().

◆ fallback8bitEncoding()

Language::fallback8bitEncoding ( )

Returns: array

Definition at line 2802 of file Language.php.

Referenced by checkTitleEncoding().

◆ fetchLanguageName()

static Language::fetchLanguageName	(	$code,
		$inLanguage = `null`,
		$include = `'all'`
	)

static

Parameters

string	$code	The code of the language for which to get the name
null \| string	$inLanguage	Code of language in which to return the name (null for autonyms)
string	$include	'all', 'mw' or 'mwfile'; see fetchLanguageNames()

Returns: string Language name or empty

Since: 1.20

Definition at line 886 of file Language.php.

References $code.

◆ fetchLanguageNames()

static Language::fetchLanguageNames	(	$inLanguage = `null`,
		$include = `'mw'`
	)

static

Get an array of language names, indexed by code.

Parameters

null \| string	$inLanguage	Code of language in which to return the names Use null for autonyms (native names)
string	$include	One of: 'all' all available languages 'mw' only if the language is defined in MediaWiki or wgExtraLanguageNames (default) 'mwfile' only if the language is in 'mw' and has a message file

Returns: array Language code => language name

Since: 1.20

Definition at line 798 of file Language.php.

◆ fetchLanguageNamesUncached()

static Language::fetchLanguageNamesUncached	(	$inLanguage = `null`,
		$include = `'mw'`
	)

staticprivate

Uncached helper for fetchLanguageNames.

Parameters

null \| string	$inLanguage	Code of language in which to return the names Use null for autonyms (native names)
string	$include	One of: 'all' all available languages 'mw' only if the language is defined in MediaWiki or wgExtraLanguageNames (default) 'mwfile' only if the language is in 'mw' and has a message file

Returns: array Language code => language name

Definition at line 823 of file Language.php.

References of, other(), and the.

◆ findVariantLink()

Language::findVariantLink	(	&	$link,
		&	$nt,
			$ignoreOtherCond = `false`
	)

If a language supports multiple variants, it is possible that non-existing link in one variant actually exists in another variant.

this function tries to find it. See e.g. LanguageZh.php The input parameters may be modified upon return

Parameters

string	&$link	The name of the link
Title	&$nt	The title object of the link
bool	$ignoreOtherCond	To disable other conditions when we need to transclude a template or update a category's link

Definition at line 4100 of file Language.php.

References $link.

◆ firstChar()

Language::firstChar ( $s )

Get the first character of a string.

Parameters

string $s

Returns: string

Definition at line 2890 of file Language.php.

References $code, $matches, and $s.

◆ fixVariableInNamespace()

Language::fixVariableInNamespace ( $talk )

Parameters

string $talk

Returns: mixed

Definition at line 4416 of file Language.php.

References $wgMetaNamespace, and global.

Referenced by getNamespaceAliases(), and getNamespaces().

◆ formatBitrate()

Language::formatBitrate ( $bps )

Format a bitrate for output, using an appropriate unit (bps, kbps, Mbps, Gbps, Tbps, Pbps, Ebps, Zbps or Ybps) according to the magnitude in question.

This use base 1000. For base 1024 use formatSize(), for another base see formatComputingNumbers().

Parameters

int $bps

Returns: string

Definition at line 4580 of file Language.php.

References formatComputingNumbers().

◆ formatComputingNumbers()

Language::formatComputingNumbers	(	$size,
		$boundary,
		$messageKey
	)

Parameters

int	$size	Size of the unit
int	$boundary	Size boundary (1000, or 1024 in most cases)
string	$messageKey	Message key to be uesd

Returns: string

Definition at line 4590 of file Language.php.

References formatNum(), and getMessageFromDB().

Referenced by formatBitrate(), and formatSize().

◆ formatDuration()

Language::formatDuration	(		$seconds,
		array	$chosenIntervals = `[]`
	)

Takes a number of seconds and turns it into a text using values such as hours and minutes.

Since: 1.20

Parameters

int	$seconds	The amount of seconds.
array	$chosenIntervals	The intervals to enable.

Returns: string

Reimplemented in LanguageZh_hans.

Definition at line 2285 of file Language.php.

References as, getDurationIntervals(), listToText(), and wfMessage().

Referenced by translateBlockExpiry().

◆ formatExpiry()

Language::formatExpiry	(	$expiry,
		$format = `true`,
		$infinity = `'infinity'`
	)

Decode an expiry (block, protection, etc) which has come from the DB.

Parameters

string	$expiry	Database expiry String
bool \| int	$format	True to process using language functions, or TS_ constant to return the expiry in a given timestamp
string	$infinity	If $format is not true, use this string for infinite expiry

Returns: string

Since: 1.18

Definition at line 4451 of file Language.php.

References DB_SLAVE, getMessageFromDB(), timeanddate(), wfGetDB(), and wfTimestamp().

◆ formatNum()

Language::formatNum	(	$number,
		$nocommafy = `false`
	)

Normally we output all numbers in plain en_US style, that is 293,291.235 for twohundredninetythreethousand-twohundredninetyone point twohundredthirtyfive.

However this is not suitable for all languages, some such as Bengali (bn) want ২,৯৩,২৯১.২৩৫ and others such as Icelandic just want to use commas instead of dots, and dots instead of commas like "293.291,235".

An example of this function being called: wfMessage( 'message' )->numParams( $num )->text()

See $separatorTransformTable on MessageIs.php for the , => . and . => , implementation.

Todo:: check if it's viable to use localeconv() for the decimal separator thing.

Parameters

int \| float	$number	The string to be formatted, should be an integer or a floating point number.
bool	$nocommafy	Set to true for special numbers like dates

Returns: string

Definition at line 3259 of file Language.php.

References $s, $wgTranslateNumerals, commafy(), digitTransformTable(), global, and separatorTransformTable().

Referenced by formatComputingNumbers(), formatNumNoSeparators(), formatTimePeriod(), sprintfDate(), and viewPrevNext().

◆ formatNumNoSeparators()

Language::formatNumNoSeparators ( $number )

Front-end for non-commafied formatNum.

Parameters

int | float $number The string to be formatted, should be an integer or a floating point number.

Since: 1.21

Returns: string

Definition at line 3287 of file Language.php.

References formatNum().

◆ formatSize()

Language::formatSize ( $size )

Format a size in bytes for output, using an appropriate unit (B, KB, MB, GB, TB, PB, EB, ZB or YB) according to the magnitude in question.

This method use base 1024. For base 1000 use formatBitrate(), for another base see formatComputingNumbers()

Parameters

int $size Size to format

Returns: string Plain text (not HTML)

Definition at line 4628 of file Language.php.

References formatComputingNumbers().

◆ formatTimePeriod()

Language::formatTimePeriod	(	$seconds,
		$format = `[]`
	)

Todo:: Document

Parameters

int \| float	$seconds
array	$format	Optional If $format['avoid'] === 'avoidseconds': don't mention seconds if $seconds >= 1 hour. If $format['avoid'] === 'avoidminutes': don't mention seconds/minutes if $seconds > 48 hours. If $format['noabbrevs'] is true: use 'seconds' and friends instead of 'seconds-abbrev' and friends. For backwards compatibility, $format may also be one of the strings 'avoidseconds' or 'avoidminutes'.

Returns: string

Definition at line 4480 of file Language.php.

References $s, formatNum(), formatTimePeriod(), and wfMessage().

Referenced by formatTimePeriod().

◆ gender()

Language::gender	(	$gender,
		$forms
	)

Provides an alternative text depending on specified gender.

Usage {{gender:username|masculine|feminine|unknown}}. username is optional, in which case the gender of current user is used, but only in (some) interface messages; otherwise default gender is used.

If no forms are given, an empty string is returned. If only one form is given, it will be returned unconditionally. These details are implied by the caller and cannot be overridden in subclasses.

If three forms are given, the default is to use the third (unknown) form. If fewer than three forms are given, the default is to use the first (masculine) form. These details can be overridden in subclasses.

Parameters

string	$gender
array	$forms

Returns: string

Definition at line 3783 of file Language.php.

References preConvertPlural().

◆ getAllMessages()

Language::getAllMessages ( )

Returns: array

Definition at line 2579 of file Language.php.

◆ getArrow()

Language::getArrow ( $direction = 'forwards' )

An arrow, depending on the language direction.

Parameters

string $direction The direction of the arrow: forwards (default), backwards, left, right, up, down.

Returns: string

Definition at line 3123 of file Language.php.

References isRTL().

◆ getBookstoreList()

Language::getBookstoreList ( )

Exports $wgBookstoreListEn.

Returns: array

Definition at line 450 of file Language.php.

◆ getCode()

Language::getCode ( )

Get the internal language code for this language object.

NOTE: The return value of this function is NOT HTML-safe and must be escaped with htmlspecialchars() or similar

Returns: string

Definition at line 4211 of file Language.php.

Referenced by LanguageHu\convertGrammar(), convertGrammar(), doMagicHook(), getGrammarForms(), getHtmlCode(), getParentLanguage(), getSpecialPageAliases(), and Message\inLanguage().

◆ getCodeFromFileName()

static Language::getCodeFromFileName	(	$filename,
		$prefix = `'Language'`,
		$suffix = `'.php'`
	)

static

Get the language code from a file name.

Inverse of getFileName()

Parameters

string	$filename	$prefix . $languageCode . $suffix
string	$prefix	Prefix before the language code
string	$suffix	Suffix after the language code

Returns: string Language code, or false if $prefix or $suffix isn't found

Definition at line 4249 of file Language.php.

◆ getCompiledPluralRules()

Language::getCompiledPluralRules ( )

Get the compiled plural rules for the language.

Since: 1.20

Returns: array Associative array with plural form, and plural rule as key-value pairs

Definition at line 4735 of file Language.php.

References as, and getFallbacksFor().

Referenced by getPluralRuleIndexNumber().

◆ getConverter()

Language::getConverter ( )

Return the LanguageConverter used in the Language.

Since: 1.19

Returns: LanguageConverter

Definition at line 3974 of file Language.php.

Referenced by getNamespaceAliases().

◆ getConvRuleTitle()

Language::getConvRuleTitle ( )

Get the conversion rule title, if any.

Returns: string

Definition at line 4726 of file Language.php.

◆ getDateFormats()

Language::getDateFormats ( )

Returns: array

Definition at line 732 of file Language.php.

◆ getDateFormatString()

Language::getDateFormatString	(	$type,
		$pref
	)

Get a format string for a given type and preference.

Parameters

string	$type	May be 'date', 'time', 'both', or 'pretty'.
string	$pref	The format name as it appears in Messages*.php under $datePreferences.

Since: 1.22 New type 'pretty' that provides a more readable timestamp format

Returns: string

Definition at line 2193 of file Language.php.

References $type, getDateFormatString(), and getDefaultDateFormat().

Referenced by date(), getDateFormatString(), getHumanTimestampInternal(), internalUserTimeAndDate(), time(), and timeanddate().

◆ getDatePreferenceMigrationMap()

Language::getDatePreferenceMigrationMap ( )

Returns: array

Definition at line 752 of file Language.php.

◆ getDatePreferences()

Language::getDatePreferences ( )

Returns: array

Definition at line 725 of file Language.php.

◆ getDefaultDateFormat()

Language::getDefaultDateFormat ( )

Returns: array|string

Definition at line 739 of file Language.php.

References or.

Referenced by getDateFormatString().

◆ getDefaultVariant()

Language::getDefaultVariant ( )

Returns: string

Definition at line 4077 of file Language.php.

◆ getDir()

Language::getDir ( )

Return the correct HTML 'dir' attribute value for this language.

Returns: string

Definition at line 3044 of file Language.php.

References isRTL().

◆ getDirMark()

Language::getDirMark ( $opposite = false )

A hidden direction mark (LRM or RLM), depending on the language direction.

This function produces them as invisible Unicode characters and the output may be hard to read and debug, so it should only be used when the output is plain text or can be escaped. When the output is HTML, use getDirMarkEntity() instead.

Parameters

bool $opposite Get the direction mark opposite to your language

Returns: string

Definition at line 3100 of file Language.php.

References isRTL().

Referenced by specialList().

◆ getDirMarkEntity()

Language::getDirMarkEntity ( $opposite = false )

A hidden direction mark (LRM or RLM), depending on the language direction.

Unlike getDirMark(), this function returns the character as an HTML entity. This function should be used when the output is guaranteed to be HTML, because it makes the output HTML source code more readable. When the output is plain text or can be escaped, getDirMark() should be used.

Parameters

bool $opposite Get the direction mark opposite to your language

Returns: string

Since: 1.20

Definition at line 3083 of file Language.php.

References isRTL().

◆ getDurationIntervals()

Language::getDurationIntervals	(		$seconds,
		array	$chosenIntervals = `[]`
	)

Takes a number of seconds and returns an array with a set of corresponding intervals.

For example 65 will be turned into array( minutes => 1, seconds => 5 ).

Since: 1.20

Parameters

int	$seconds	The amount of seconds.
array	$chosenIntervals	The intervals to enable.

Returns: array

Definition at line 2311 of file Language.php.

References $name, $value, and as.

Referenced by LanguageZh_hans\formatDuration(), and formatDuration().

◆ getExtraHashOptions()

Language::getExtraHashOptions ( )

returns language specific options used by User::getPageRenderHash() for example, the preferred language variant

Returns: string

Definition at line 4110 of file Language.php.

◆ getExtraUserToggles()

Language::getExtraUserToggles ( )

Returns: array

Definition at line 775 of file Language.php.

◆ getFallbackFor()

static Language::getFallbackFor ( $code )

static

Get the first fallback for a given language.

Parameters

string $code

Returns: bool|string

Definition at line 4321 of file Language.php.

References $code.

◆ getFallbackLanguages()

Language::getFallbackLanguages ( )

Returns: array

Since: 1.19

Definition at line 442 of file Language.php.

Referenced by addMagicWordsByLang().

◆ getFallbacksFor()

static Language::getFallbacksFor ( $code )

static

Get the ordered list of fallback languages.

Since: 1.19

Parameters

string $code Language code

Returns: array Non-empty array, ending in "en"

Definition at line 4336 of file Language.php.

References $code, and isValidBuiltInCode().

Referenced by getCompiledPluralRules(), getPluralRules(), getPluralRuleTypes(), and newFromCode().

◆ getFallbacksIncludingSiteLanguage()

static Language::getFallbacksIncludingSiteLanguage ( $code )

static

Get the ordered list of fallback languages, ending with the fallback language chain for the site language.

Since: 1.22

Parameters

string $code Language code

Returns: array Array( fallbacks, site fallbacks )

Definition at line 4353 of file Language.php.

References $code, $wgLanguageCode, and global.

◆ getFileName()

static Language::getFileName	(	$prefix = `'Language'`,
		$code,
		$suffix = `'.php'`
	)

static

Get the name of a file for a certain language code.

Parameters

string	$prefix	Prepend this to the filename
string	$code	Language code
string	$suffix	Append this to the filename

Exceptions

MWException

Returns: string $prefix . $mangledCode . $suffix

Definition at line 4279 of file Language.php.

References $code, and ucfirst().

◆ getFormattedNamespaces()

Language::getFormattedNamespaces ( )

A convenience function that returns getNamespaces() with spaces instead of underscores in values.

Useful for producing output to be displayed e.g. in <select> forms.

Returns: array

Definition at line 519 of file Language.php.

References as, and getNamespaces().

◆ getFormattedNsText()

Language::getFormattedNsText ( $index )

A convenience function that returns the same thing as getNsText() except with '_' changed to ' ', useful for producing output.

$mw_ns = $wgContLang->getFormattedNsText( NS_MEDIAWIKI_TALK ); echo $mw_ns; // prints 'MediaWiki talk'

Parameters

int $index The array key of the namespace to return

Returns: string Namespace name without underscores (empty string if namespace does not exist)

Definition at line 556 of file Language.php.

References getNsText().

◆ getGenderNsText()

Language::getGenderNsText	(	$index,
		$gender
	)

Returns gender-dependent namespace alias if available.

See https://www.mediawiki.org/wiki/Manual:$wgExtraGenderNamespaces

Parameters

int	$index	Namespace index
string	$gender	Gender key (male, female... )

Returns: string

Since: 1.18

Definition at line 569 of file Language.php.

References $wgExtraGenderNamespaces, array(), getNsText(), and global.

◆ getGrammarForms()

Language::getGrammarForms ( )

Get the grammar forms for the content language.

Returns: array Array of grammar forms

Since: 1.20

Definition at line 3754 of file Language.php.

References $wgGrammarForms, getCode(), and global.

◆ getHebrewCalendarMonthName()

Language::getHebrewCalendarMonthName ( $key )

Parameters

string $key

Returns: string

Definition at line 986 of file Language.php.

References getMessageFromDB().

Referenced by sprintfDate().

◆ getHebrewCalendarMonthNameGen()

Language::getHebrewCalendarMonthNameGen ( $key )

Parameters

string $key

Returns: string

Definition at line 994 of file Language.php.

References getMessageFromDB().

Referenced by sprintfDate().

◆ getHijriCalendarMonthName()

Language::getHijriCalendarMonthName ( $key )

Parameters

string $key

Returns: string

Definition at line 1002 of file Language.php.

References getMessageFromDB().

Referenced by sprintfDate().

◆ getHtmlCode()

Language::getHtmlCode ( )

Get the code in BCP 47 format which we can use inside of html lang="" tags.

NOTE: The return value of this function is NOT HTML-safe and must be escaped with htmlspecialchars() or similar.

Since: 1.19

Returns: string

Definition at line 4225 of file Language.php.

References getCode(), and wfBCP47().

◆ getHumanTimestamp()

Language::getHumanTimestamp	(	MWTimestamp	$time,
		MWTimestamp	$relativeTo = `null`,
		User	$user = `null`
	)

Get the timestamp in a human-friendly relative format, e.g., "3 days ago".

Determine the difference between the timestamp and the current time, and generate a readable timestamp by returning "<N> <units> ago", where the largest possible unit is used.

Since: 1.26 (Prior to 1.26 method existed but was not meant to be used directly)

Parameters

MWTimestamp	$time
MWTimestamp \| null	$relativeTo	The base timestamp to compare to (defaults to now)
User \| null	$user	User the timestamp is being generated for (or null to use main context's user)

Returns: string Formatted timestamp

Definition at line 2466 of file Language.php.

References $time, $user, getHumanTimestampInternal(), and RequestContext\getMain().

◆ getHumanTimestampInternal()

Language::getHumanTimestampInternal	(	MWTimestamp	$ts,
		MWTimestamp	$relativeTo,
		User	$user
	)

private

Convert an MWTimestamp into a pretty human-readable timestamp using the given user preferences and relative base time.

See also: Language::getHumanTimestamp

Parameters

MWTimestamp	$ts	Timestamp to prettify
MWTimestamp	$relativeTo	Base timestamp
User	$user	User preferences to use

Returns: string Human timestamp

Since: 1.26

Definition at line 2503 of file Language.php.

References $user, MWTimestamp\diff(), MWTimestamp\format(), getDateFormatString(), MWTimestamp\getTimestamp(), sprintfDate(), TS_MW, and wfMessage().

Referenced by getHumanTimestamp().

◆ getImageFile()

Language::getImageFile ( $image )

Parameters

string $image

Returns: array|null

Definition at line 760 of file Language.php.

◆ getImageFiles()

Language::getImageFiles ( )

Returns: array

Since: 1.24

Definition at line 768 of file Language.php.

◆ getIranianCalendarMonthName()

Language::getIranianCalendarMonthName ( $key )

Parameters

string $key

Returns: string

Definition at line 978 of file Language.php.

References getMessageFromDB().

Referenced by sprintfDate().

◆ getJsonMessagesFileName()

static Language::getJsonMessagesFileName ( $code )

static

Parameters

string $code

Returns: string

Exceptions

MWException

Since: 1.23

Definition at line 4304 of file Language.php.

References $code, $IP, and global.

◆ getLocalisationCache()

static Language::getLocalisationCache ( )

static

Get the LocalisationCache instance.

Returns: LocalisationCache

Definition at line 402 of file Language.php.

References $wgLocalisationCacheConf, and global.

◆ getLocalNsIndex()

Language::getLocalNsIndex ( $text )

Get a namespace key by value, case insensitive.

Only matches namespace names for the current language, not the canonical ones defined in Namespace.php.

Parameters

string $text

Returns: int|bool An integer if $text is a valid value otherwise false

Definition at line 608 of file Language.php.

References getNamespaceIds(), and lc().

◆ getMagic()

Language::getMagic ( $mw )

Fill a MagicWord object with data from here.

Parameters

MagicWord $mw

Definition at line 3173 of file Language.php.

References doMagicHook(), and wfWarn().

◆ getMagicWords()

Language::getMagicWords ( )

Get all magic words from cache.

Returns: array

Definition at line 3153 of file Language.php.

◆ getMessage()

Language::getMessage ( $key )

Parameters

string $key

Returns: array|null

Reimplemented in LanguageQqx.

Definition at line 2572 of file Language.php.

◆ getMessageFor()

static Language::getMessageFor	(	$key,
		$code
	)

static

Get a message for a given language.

Parameters

string	$key
string	$code

Returns: string

Definition at line 4396 of file Language.php.

References $code.

◆ getMessageFromDB()

Language::getMessageFromDB ( $msg )

Get a message from the MediaWiki namespace.

Parameters

string $msg Message name

Returns: string

Definition at line 898 of file Language.php.

References msg().

Referenced by formatComputingNumbers(), formatExpiry(), getHebrewCalendarMonthName(), getHebrewCalendarMonthNameGen(), getHijriCalendarMonthName(), getIranianCalendarMonthName(), getMonthAbbreviation(), getMonthName(), getMonthNameGen(), getVariantname(), getWeekdayAbbreviation(), and getWeekdayName().

◆ getMessageKeysFor()

static Language::getMessageKeysFor ( $code )

static

Get all message keys for a given language.

This is a faster alternative to array_keys( Language::getMessagesFor( $code ) )

Since: 1.19

Parameters

string $code Language code

Returns: array Array of message keys (strings)

Definition at line 4408 of file Language.php.

References $code.

◆ getMessagesFileName()

static Language::getMessagesFileName ( $code )

static

Parameters

string $code

Returns: string

Definition at line 4291 of file Language.php.

References $code, $IP, and global.

◆ getMessagesFor()

static Language::getMessagesFor ( $code )

static

Get all messages for a given language WARNING: this may take a long time.

If you just need all message keys but need the contents of only a few messages, consider using getMessageKeysFor().

Parameters

string $code

Returns: array

Definition at line 4384 of file Language.php.

References $code.

◆ getMonthAbbreviation()

Language::getMonthAbbreviation ( $key )

Parameters

string $key

Returns: string

Definition at line 943 of file Language.php.

References getMessageFromDB().

Referenced by getMonthAbbreviationsArray(), and sprintfDate().

◆ getMonthAbbreviationsArray()

Language::getMonthAbbreviationsArray ( )

Returns: array

Definition at line 950 of file Language.php.

References $i, and getMonthAbbreviation().

◆ getMonthName()

Language::getMonthName ( $key )

Parameters

string $key

Returns: string

Definition at line 916 of file Language.php.

References getMessageFromDB().

Referenced by LanguageWa\date(), getMonthNamesArray(), and sprintfDate().

◆ getMonthNameGen()

Language::getMonthNameGen ( $key )

Parameters

string $key

Returns: string

Definition at line 935 of file Language.php.

References getMessageFromDB().

Referenced by sprintfDate().

◆ getMonthNamesArray()

Language::getMonthNamesArray ( )

Returns: array

Definition at line 923 of file Language.php.

References $i, and getMonthName().

◆ getNamespaceAliases()

Language::getNamespaceAliases ( )

Returns: array

Definition at line 617 of file Language.php.

References $name, $namespaceAliases, $wgExtraGenderNamespaces, array(), as, fixVariableInNamespace(), getConverter(), getNamespaces(), getVariants(), global, and NS_PROJECT_TALK.

Referenced by getNamespaceIds().

◆ getNamespaceIds()

Language::getNamespaceIds ( )

Returns: array

Definition at line 661 of file Language.php.

References $name, $wgNamespaceAliases, as, getNamespaceAliases(), getNamespaces(), global, and lc().

Referenced by getLocalNsIndex(), and getNsIndex().

◆ getNamespaces()

Language::getNamespaces ( )

Returns an array of localised namespaces indexed by their numbers.

If the namespace is not available in localised form, it will be included in English.

Returns: array

Definition at line 460 of file Language.php.

References $namespaceNames, $wgExtraNamespaces, $wgMetaNamespace, $wgMetaNamespaceTalk, as, fixVariableInNamespace(), MWNamespace\getCanonicalNamespaces(), global, NS_PROJECT, and NS_PROJECT_TALK.

Referenced by getFormattedNamespaces(), getNamespaceAliases(), getNamespaceIds(), and getNsText().

◆ getNsIndex()

Language::getNsIndex ( $text )

Get a namespace key by value, case insensitive.

Canonical namespace names override custom ones defined for the current language.

Parameters

string $text

Returns: int|bool An integer if $text is a valid value otherwise false

Definition at line 691 of file Language.php.

References MWNamespace\getCanonicalIndex(), getNamespaceIds(), and lc().

◆ getNsText()

Language::getNsText ( $index )

Get a namespace value by key.

$mw_ns = $wgContLang->getNsText( NS_MEDIAWIKI ); echo $mw_ns; // prints 'MediaWiki'

Parameters

int $index The array key of the namespace to return

Returns: string|bool String if the namespace value exists, otherwise false

Definition at line 538 of file Language.php.

References getNamespaces().

Referenced by getFormattedNsText(), and getGenderNsText().

◆ getParentLanguage()

Language::getParentLanguage ( )

Get the "parent" language which has a converter to convert a "compatible" language (in another variant) to this language (eg.

zh for zh-cn, but not en for en-gb).

Returns: Language|null

Since: 1.22

Definition at line 4183 of file Language.php.

References $code, $lang, LanguageConverter\$languagesWithVariants, factory(), and getCode().

◆ getParsedTitle()

Language::getParsedTitle ( )

For languages that support multiple variants, the title of an article may be displayed differently in different variants.

this function returns the apporiate title defined in the body of the article.

Returns: string

Definition at line 4121 of file Language.php.

◆ getPluralRuleIndexNumber()

Language::getPluralRuleIndexNumber ( $number )

Find the index number of the plural rule appropriate for the given number.

Parameters

int $number

Returns: int The index number of the plural rule

Definition at line 4792 of file Language.php.

References getCompiledPluralRules().

Referenced by convertPlural(), and getPluralRuleType().

◆ getPluralRules()

Language::getPluralRules ( )

Get the plural rules for the language.

Since: 1.20

Returns: array Associative array with plural form number and plural rule as key-value pairs

Definition at line 4754 of file Language.php.

References as, and getFallbacksFor().

◆ getPluralRuleType()

Language::getPluralRuleType ( $number )

Find the plural rule type appropriate for the given number For example, if the language is set to Arabic, getPluralType(5) should return 'few'.

Since: 1.22

Parameters

int $number

Returns: string The name of the plural rule type, e.g. one, two, few, many

Definition at line 4806 of file Language.php.

References getPluralRuleIndexNumber(), and getPluralRuleTypes().

◆ getPluralRuleTypes()

Language::getPluralRuleTypes ( )

Get the plural rule types for the language.

Since: 1.22

Returns: array Associative array with plural form number and plural rule type as key-value pairs

Definition at line 4773 of file Language.php.

References as, and getFallbacksFor().

Referenced by getPluralRuleType().

◆ getPreferredVariant()

Language::getPreferredVariant ( )

Returns: string

Definition at line 4070 of file Language.php.

Referenced by LanguageKk\convertGrammar(), LanguageKk\lcfirst(), and LanguageKk\ucfirst().

◆ getSpecialPageAliases()

Language::getSpecialPageAliases ( )

Get special page names, as an associative array canonical name => array of valid names, including aliases.

Returns: array

Definition at line 3214 of file Language.php.

References getCode().

◆ getURLVariant()

Language::getURLVariant ( )

Returns: string

Definition at line 4084 of file Language.php.

◆ getUserToggle()

Language::getUserToggle ( $tog )

Parameters

string $tog

Returns: string

Definition at line 783 of file Language.php.

◆ getVariantname()

Language::getVariantname	(	$code,
		$usemsg = `true`
	)

short names for language variants used for language conversion links.

Parameters

string	$code
bool	$usemsg	Use the "variantname-xyz" message if it exists

Returns: string

Definition at line 708 of file Language.php.

References $code, $name, getMessageFromDB(), and wfMessage().

◆ getVariants()

Language::getVariants ( )

Get the list of variants supported by this language see sample implementation in LanguageZh.php.

Returns: array An array of language codes

Definition at line 4063 of file Language.php.

Referenced by getNamespaceAliases(), and hasVariants().

◆ getWeekdayAbbreviation()

Language::getWeekdayAbbreviation ( $key )

Parameters

string $key

Returns: string

Definition at line 970 of file Language.php.

References getMessageFromDB().

Referenced by sprintfDate().

◆ getWeekdayName()

Language::getWeekdayName ( $key )

Parameters

string $key

Returns: string

Definition at line 962 of file Language.php.

References getMessageFromDB().

Referenced by sprintfDate().

◆ handleExplicitPluralForms()

Language::handleExplicitPluralForms	(		$count,
		array	$forms
	)

protected

Handles explicit plural forms for Language::convertPlural()

In {{PLURAL:$1|0=nothing|one|many}}, 0=nothing will be returned if $1 equals zero. If an explicitly defined plural form matches the $count, then string value returned, otherwise array returned for further consideration by CLDR rules or overridden convertPlural().

Since: 1.23

Parameters

int	$count	Non-localized number
array	$forms	Different plural forms

Returns: array|string

Definition at line 3842 of file Language.php.

References $count, and as.

Referenced by LanguageKsh\convertPlural(), and convertPlural().

◆ hasVariant()

Language::hasVariant ( $variant )

Check if the language has the specific variant.

Since: 1.19

Parameters

string $variant

Returns: bool

Definition at line 4034 of file Language.php.

◆ hasVariants()

Language::hasVariants ( )

Check if this is a language with variants.

Returns: bool

Definition at line 4023 of file Language.php.

References getVariants().

◆ hasWordBreaks()

Language::hasWordBreaks ( )

Most writing systems use whitespace to break up words.

Some languages such as Chinese don't conventionally do this, which requires special handling when breaking up words for searching etc.

Returns: bool

Reimplemented in LanguageYue, and LanguageZh_hans.

Definition at line 2814 of file Language.php.

◆ hebrewNumeral()

static Language::hebrewNumeral ( $num )

static

Hebrew Gematria number formatting up to 9999.

Parameters

int $num

Returns: string

Definition at line 1993 of file Language.php.

References $i, and array().

◆ hebrewYearStart()

static Language::hebrewYearStart ( $year )

staticprivate

This calculates the Hebrew year start, as days since 1 September.

Based on Carl Friedrich Gauss algorithm for finding Easter date. Used for Hebrew date.

Parameters

int $year

Returns: string

Definition at line 1809 of file Language.php.

◆ iconv()

Language::iconv	(	$in,
		$out,
		$string
	)

Parameters

string	$in
string	$out
string	$string

Returns: string

Reimplemented in LanguageEo.

Definition at line 2589 of file Language.php.

References $out, and iconv().

Referenced by checkTitleEncoding(), iconv(), recodeForEdit(), and recodeInput().

◆ initContLang()

Language::initContLang ( )

Hook which will be called if this is the content language.

Descendants can use this to register hook functions or modify globals

Definition at line 435 of file Language.php.

◆ initEncoding()

Language::initEncoding ( )

Reimplemented in LanguageEo.

Definition at line 2942 of file Language.php.

◆ insertSpace()

static Language::insertSpace	(	$string,
		$pattern
	)

staticprotected

Parameters

string	$string
string	$pattern

Returns: string

Definition at line 2868 of file Language.php.

Referenced by LanguageJa\segmentByWord(), LanguageYue\segmentByWord(), and LanguageZh_hans\segmentByWord().

◆ internalUserTimeAndDate()

Language::internalUserTimeAndDate	(		$type,
			$ts,
		User	$user,
		array	$options
	)

private

Internal helper function for userDate(), userTime() and userTimeAndDate()

Parameters

string	$type	Can be 'date', 'time' or 'both'
string	$ts	The time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts)
User	$user	User object used to get preferences for timezone and format
array	$options	Array, can contain the following keys: 'timecorrection': time correction, can have the following values: true: use user's preference false: don't use time correction int: value of time correction in minutes 'format': format to use, can have the following values: true: use user's preference false: use default preference string: format to use

Since: 1.19

Returns: string

Definition at line 2362 of file Language.php.

References $options, $type, $user, dateFormat(), getDateFormatString(), sprintfDate(), true, TS_MW, userAdjust(), and wfTimestamp().

Referenced by userDate(), userTime(), and userTimeAndDate().

◆ isKnownLanguageTag()

static Language::isKnownLanguageTag ( $tag )

static

Returns true if a language code is an IETF tag known to MediaWiki.

Parameters

string $tag

Since: 1.21

Returns: bool

Definition at line 381 of file Language.php.

References $tag.

◆ isMultibyte()

Language::isMultibyte ( $str )

Parameters

string $str

Returns: bool

Definition at line 2707 of file Language.php.

Referenced by lc(), uc(), ucwordbreaks(), and ucwords().

◆ isRTL()

Language::isRTL ( )

For right-to-left language support.

Returns: bool

Definition at line 3036 of file Language.php.

Referenced by alignEnd(), alignStart(), getArrow(), getDir(), getDirMark(), and getDirMarkEntity().

◆ isSupportedLanguage()

static Language::isSupportedLanguage ( $code )

static

Checks whether any localisation is available for that language tag in MediaWiki (MessagesXx.php exists).

Parameters

string $code Language tag (in lower case)

Returns: bool Whether language is supported

Since: 1.21

Definition at line 251 of file Language.php.

References $code.

◆ isValidBuiltInCode()

static Language::isValidBuiltInCode ( $code )

static

Returns true if a language code is of a valid form for the purposes of internal customisation of MediaWiki, via Messages*.php or *.json.

Parameters

string $code

Exceptions

MWException

Since: 1.18

Returns: bool

Definition at line 358 of file Language.php.

References $code, and $type.

Referenced by getFallbacksFor(), and newFromCode().

◆ isValidCode()

static Language::isValidCode ( $code )

static

Returns true if a language code string is of a valid form, whether or not it exists.

This includes codes which are used solely for customisation via the MediaWiki namespace.

Parameters

string $code

Returns: bool

Definition at line 333 of file Language.php.

References $cache, $code, and MediaWikiTitleCodec\getTitleInvalidRegex().

Referenced by newFromCode().

◆ isWellFormedLanguageTag()

static Language::isWellFormedLanguageTag	(	$code,
		$lenient = `false`
	)

static

Returns true if a language code string is a well-formed language tag according to RFC 5646.

This function only checks well-formedness; it doesn't check that language, script or variant codes actually exist in the repositories.

Based on regexes by Mark Davis of the Unicode Consortium: http://unicode.org/repos/cldr/trunk/tools/java/org/unicode/cldr/util/data/langtagRegex.txt

Parameters

string	$code
bool	$lenient	Whether to allow '_' as separator. The default is only '-'.

Returns: bool

Since: 1.21

Definition at line 279 of file Language.php.

References $code, $s, or, other(), and use.

◆ lc()

Language::lc	(	$str,
		$first = `false`
	)

Parameters

string	$str
bool	$first

Returns: mixed|string

Definition at line 2691 of file Language.php.

References isMultibyte().

Referenced by getLocalNsIndex(), getNamespaceIds(), getNsIndex(), lcfirst(), ucwordbreaks(), and ucwords().

◆ lcfirst()

Language::lcfirst ( $str )

Parameters

string $str

Returns: mixed|string

Reimplemented in LanguageKaa, LanguageKk, and LanguageTr.

Definition at line 2672 of file Language.php.

References lc().

◆ linkPrefixCharset()

Language::linkPrefixCharset ( )

A regular expression character set to match legal word-prefixing characters which should be merged onto a link of the form foo[[bar]].

Returns: string

Definition at line 4172 of file Language.php.

◆ linkPrefixExtension()

Language::linkPrefixExtension ( )

To allow "foo[[bar]]" to extend the link over the whole word "foobar".

Returns: bool

Definition at line 3145 of file Language.php.

◆ linkTrail()

Language::linkTrail ( )

A regular expression to match legal word-trailing characters which should be merged onto a link of the form [[foo]]bar.

Returns: string

Definition at line 4162 of file Language.php.

◆ listToText()

Language::listToText ( array $l )

Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separator message.

The last two strings are chained with an "and". NOTE: This function will only work with standard numeric array keys (0, 1, 2…)

Parameters

string[] $l

Returns: string

Definition at line 3399 of file Language.php.

References $i, $s, and msg().

Referenced by formatDuration().

◆ markNoConversion()

Language::markNoConversion	(	$text,
		$noParse = `false`
	)

Prepare external link text for conversion.

When the text is a URL, it shouldn't be converted, and it'll be wrapped in the "raw" tag (-{R| }-) to prevent conversion.

This function is called "markNoConversion" for historical reasons.

Parameters

string	$text	Text to be used for external link
bool	$noParse	Wrap it without confirming it's a real URL first

Returns: string The tagged text

Definition at line 4147 of file Language.php.

References wfUrlProtocolsWithoutProtRel().

◆ msg()

Language::msg ( $msg )

protected

Get message object in this language.

Only for use inside this class.

Parameters

string $msg Message name

Returns: Message

Definition at line 908 of file Language.php.

References wfMessage().

Referenced by getMessageFromDB(), listToText(), and specialList().

◆ needsGenderDistinction()

Language::needsGenderDistinction ( )

Whether this language uses gender-dependent namespace aliases.

See https://www.mediawiki.org/wiki/Manual:$wgExtraGenderNamespaces

Returns: bool

Since: 1.18

Definition at line 584 of file Language.php.

References $wgExtraGenderNamespaces, $wgExtraNamespaces, global, NS_USER, and NS_USER_TALK.

◆ newFromCode()

static Language::newFromCode ( $code )

staticprotected

Create a language object for a given language code.

Parameters

string $code

Exceptions

MWException

Returns: Language

Definition at line 205 of file Language.php.

References $code, $lang, as, getFallbacksFor(), isValidBuiltInCode(), isValidCode(), and setCode().

◆ normalize()

Language::normalize ( $s )

Convert a UTF-8 string to normal form C.

In Malayalam and Arabic, this also cleans up certain backwards-compatible sequences, converting them to the modern Unicode equivalent.

This is language-specific for performance reasons only.

Parameters

string $s

Returns: string

Reimplemented in LanguageAr, and LanguageMl.

Definition at line 2995 of file Language.php.

References $s, $wgAllUnicodeFixes, global, and transformUsingPairFile().

◆ normalizeForSearch()

Language::normalizeForSearch ( $string )

Some languages have special punctuation need to be normalized.

Make such changes here.

Parameters

string $string

Returns: string

Reimplemented in LanguageZh_hans, LanguageBe_tarask, and LanguageYue.

Definition at line 2836 of file Language.php.

◆ numLink()

Language::numLink	(	Title	$title,
			$offset,
			$limit,
		array	$query,
			$link,
			$tooltipMsg,
			$class
	)

private

Helper function for viewPrevNext() that generates links.

Parameters

Title	$title	Title object to link
int	$offset
int	$limit
array	$query	Extra query parameters
string	$link	Text to use for the link; will be escaped
string	$tooltipMsg	Name of the message to use as tooltip
string	$class	Value of the "class" attribute of the link

Returns: string HTML fragment

Definition at line 4710 of file Language.php.

References $limit, $link, $query, $title, Html\element(), and wfMessage().

Referenced by viewPrevNext().

◆ parseFormattedNumber()

Language::parseFormattedNumber ( $number )

Parameters

string $number

Returns: string

Definition at line 3295 of file Language.php.

References $s, digitTransformTable(), and separatorTransformTable().

◆ pipeList()

Language::pipeList ( array $list )

Same as commaList, but separate it with the pipe instead.

Parameters

string[] $list Array of strings to put in a pipe list

Returns: string

Definition at line 3453 of file Language.php.

References wfMessage().

Referenced by viewPrevNext().

◆ preConvertPlural()

Language::preConvertPlural	(	$forms,
		$count
	)

protected

Checks that convertPlural was given an array and pads it to requested amount of forms by copying the last one.

Parameters

array	$forms	Array of forms given to convertPlural
int	$count	How many forms should there be at least

Returns: array Padded array of forms or an exception if not an array

Definition at line 3863 of file Language.php.

References $count.

Referenced by LanguageKsh\convertPlural(), and gender().

◆ recodeForEdit()

Language::recodeForEdit ( $s )

Parameters

string $s

Returns: string

Definition at line 2953 of file Language.php.

References $s, $wgEditEncoding, global, and iconv().

◆ recodeInput()

Language::recodeInput ( $s )

Parameters

string $s

Returns: string

Definition at line 2969 of file Language.php.

References $s, $wgEditEncoding, global, and iconv().

◆ removeBadCharFirst()

Language::removeBadCharFirst ( $string )

protected

Remove bytes that represent an incomplete Unicode character at the start of string (e.g.

bytes of the char are missing)

Parameters

string $string

Returns: string

Definition at line 3552 of file Language.php.

Referenced by truncate().

◆ removeBadCharLast()

Language::removeBadCharLast ( $string )

protected

Remove bytes that represent an incomplete Unicode character at the end of string (e.g.

bytes of the char are missing)

Parameters

string $string

Returns: string

Definition at line 3526 of file Language.php.

Referenced by truncate(), and truncateHtml().

◆ replaceGrammarInNamespace()

Language::replaceGrammarInNamespace ( $m )

Parameters

string $m

Returns: string

Definition at line 4437 of file Language.php.

References convertGrammar().

◆ resetNamespaces()

Language::resetNamespaces ( )

Resets all of the namespace caches.

Mainly used for testing

Definition at line 507 of file Language.php.

◆ romanNumeral()

static Language::romanNumeral ( $num )

static

Roman number formatting up to 10000.

Parameters

int $num

Returns: string

Definition at line 1962 of file Language.php.

References $i, and $s.

Referenced by sprintfDate().

◆ segmentByWord()

Language::segmentByWord ( $string )

Some languages such as Chinese require word segmentation, Specify such segmentation when overridden in derived class.

Parameters

string $string

Returns: string

Reimplemented in LanguageJa, LanguageYue, and LanguageZh_hans.

Definition at line 2825 of file Language.php.

◆ segmentForDiff()

Language::segmentForDiff ( $text )

languages like Chinese need to be segmented in order for the diff to be of any use

Parameters

string $text

Returns: string

Reimplemented in LanguageZh.

Definition at line 3954 of file Language.php.

◆ semicolonList()

Language::semicolonList ( array $list )

Take a list of strings and build a locale-friendly semicolon-separated list, using the local semicolon-separator message.

Parameters

string[] $list Array of strings to put in a semicolon list

Returns: string

Definition at line 3441 of file Language.php.

References wfMessage().

◆ separatorTransformTable()

Language::separatorTransformTable ( )

Returns: array

Definition at line 3386 of file Language.php.

Referenced by formatNum(), and parseFormattedNumber().

◆ setCode()

Language::setCode ( $code )

Parameters

string $code

Definition at line 4235 of file Language.php.

References $code.

Referenced by newFromCode().

◆ setNamespaces()

Language::setNamespaces ( array $namespaces )

Arbitrarily set all of the namespace names at once.

Mainly used for testing

Parameters

array $namespaces Array of namespaces (id => name)

Definition at line 499 of file Language.php.

References $namespaces.

◆ specialList()

Language::specialList	(	$page,
		$details,
		$oppositedm = `true`
	)

Make a list item, used by various special pages.

Parameters

string	$page	Page link
string	$details	HTML safe text between brackets
bool	$oppositedm	Add the direction mark opposite to your language, to display text properly

Returns: HTML escaped string

Definition at line 4641 of file Language.php.

References $page, getDirMark(), and msg().

◆ sprintfDate()

Language::sprintfDate	(		$format,
			$ts,
		DateTimeZone	$zone = `null`,
		&	$ttl = `null`
	)

This is a workalike of PHP's date() function, but with better internationalisation, a reduced set of format characters, and a better escaping format.

Supported format characters are dDjlNwzWFmMntLoYyaAgGhHiscrUeIOPTZ. See the PHP manual for definitions. There are a number of extensions, which start with "x":

xn Do not translate digits of the next numeric format character xN Toggle raw digit (xn) flag, stays set until explicitly unset xr Use roman numerals for the next numeric format character xh Use hebrew numerals for the next numeric format character xx Literal x xg Genitive month name

xij j (day number) in Iranian calendar xiF F (month name) in Iranian calendar xin n (month number) in Iranian calendar xiy y (two digit year) in Iranian calendar xiY Y (full year) in Iranian calendar

xjj j (day number) in Hebrew calendar xjF F (month name) in Hebrew calendar xjt t (days in month) in Hebrew calendar xjx xg (genitive month name) in Hebrew calendar xjn n (month number) in Hebrew calendar xjY Y (full year) in Hebrew calendar

xmj j (day number) in Hijri calendar xmF F (month name) in Hijri calendar xmn n (month number) in Hijri calendar xmY Y (full year) in Hijri calendar

xkY Y (full year) in Thai solar calendar. Months and days are identical to the Gregorian calendar xoY Y (full year) in Minguo calendar or Juche year. Months and days are identical to the Gregorian calendar xtY Y (full year) in Japanese nengo. Months and days are identical to the Gregorian calendar

Characters enclosed in double quotes will be considered literal (with the quotes themselves removed). Unmatched quotes will be considered literal quotes. Example:

"The month is" F => The month is January i's" => 20'11"

Backslash escaping is also supported.

Input timestamp is assumed to be pre-normalized to the desired local time zone, if any. Note that the format characters crUeIOPTZ will assume $ts is UTC if $zone is not given.

Parameters

	string	$format
	string	$ts	14-character timestamp YYYYMMDDHHMMSS 01234567890123
	DateTimeZone	$zone	Timezone of $ts
[out]	int	$ttl	The amount of time (in seconds) the output may be cached for. Only makes sense if $ts is the current time.

Todo:: handling of "o" format character for Iranian, Hebrew, Hijri & Thai?

Exceptions

MWException

Returns: string

Definition at line 1090 of file Language.php.

References $code, $s, dateTimeObjFormat(), format, formatNum(), getHebrewCalendarMonthName(), getHebrewCalendarMonthNameGen(), getHijriCalendarMonthName(), getIranianCalendarMonthName(), getMonthAbbreviation(), getMonthName(), getMonthNameGen(), getWeekdayAbbreviation(), getWeekdayName(), and romanNumeral().

Referenced by date(), getHumanTimestampInternal(), internalUserTimeAndDate(), time(), and timeanddate().

◆ strongDirFromContent()

static Language::strongDirFromContent ( $text = '' )

staticprivate

Gets directionality of the first strongly directional codepoint, for embedBidi()

This is the rule the BIDI algorithm uses to determine the directionality of paragraphs ( http://unicode.org/reports/tr9/#The_Paragraph_Level ) and FSI isolates ( http://unicode.org/reports/tr9/#Explicit_Directional_Isolates ).

TODO: Does not handle BIDI control characters inside the text. TODO: Does not handle unallocated characters.

Parameters

string $text Text to test

Returns: null|string Directionality ('ltr' or 'rtl') or null

Definition at line 1945 of file Language.php.

References $matches.

Referenced by embedBidi().

◆ time()

Language::time	(	$ts,
		$adj = `false`,
		$format = `true`,
		$timecorrection = `false`
	)

Parameters

string	$ts	The time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts)
bool	$adj	Whether to adjust the time output according to the user configured offset ($timecorrection)
mixed	$format	True to use user's date format preference
string \| bool	$timecorrection	The time offset as returned by validateTimeZone() in Special:Preferences

Returns: string

Definition at line 2246 of file Language.php.

References dateFormat(), getDateFormatString(), sprintfDate(), TS_MW, userAdjust(), and wfTimestamp().

Referenced by LanguageWa\timeanddate().

◆ timeanddate()

Language::timeanddate	(	$ts,
		$adj = `false`,
		$format = `true`,
		$timecorrection = `false`
	)

Parameters

string	$ts	The time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts)
bool	$adj	Whether to adjust the time output according to the user configured offset ($timecorrection)
mixed	$format	What format to return, if it's false output the default one (default true)
string \| bool	$timecorrection	The time offset as returned by validateTimeZone() in Special:Preferences

Returns: string

Reimplemented in LanguageWa.

Definition at line 2266 of file Language.php.

References dateFormat(), getDateFormatString(), sprintfDate(), TS_MW, userAdjust(), and wfTimestamp().

Referenced by formatExpiry(), and translateBlockExpiry().

◆ transformUsingPairFile()

Language::transformUsingPairFile	(	$file,
		$string
	)

Transform a string using serialized data stored in the given file (which must be in the serialized subdirectory of $IP).

The file contains pairs mapping source characters to destination characters.

The data is cached in process memory. This will go faster if you have the FastStringSearch extension.

Parameters

string	$file
string	$string

Exceptions

MWException

Returns: string

Definition at line 3020 of file Language.php.

References wfGetPrecompiledData().

Referenced by LanguageAr\normalize(), LanguageMl\normalize(), and normalize().

◆ translateBlockExpiry()

Language::translateBlockExpiry	(		$str,
		User	$user = `null`
	)

Todo:: Maybe translate block durations. Note that this function is somewhat misnamed: it deals with translating the duration ("1 week", "4 days", etc), not the expiry time (which is an absolute timestamp). Please note: do NOT add this blindly, as it is used on old expiry lengths recorded in log entries. You'd need to provide the start date to match up with it.

Parameters

string	$str	The validated block duration in English
User	$user	User object to use timezone from or null for $wgUser

Returns: string Somehow translated block duration

See also: LanguageFi.php for example implementation

Reimplemented in LanguageFi.

Definition at line 3912 of file Language.php.

References $time, $user, $value, as, formatDuration(), SpecialBlock\getSuggestedDurations(), timeanddate(), userTimeAndDate(), and wfIsInfinity().

◆ truncate()

Language::truncate	(	$string,
		$length,
		$ellipsis = `'...'`,
		$adjustLength = `true`
	)

Truncate a string to a specified length in bytes, appending an optional string (e.g.

for ellipses)

The database offers limited byte lengths for some columns in the database; multi-byte character sets mean we need to ensure that only whole characters are included, otherwise broken characters can be passed to the user

If $length is negative, the string will be truncated from the beginning

Parameters

string	$string	String to truncate
int	$length	Maximum length (including ellipses)
string	$ellipsis	String to append to the truncated text
bool	$adjustLength	Subtract length of ellipsis from $length. $adjustLength was introduced in 1.18, before that behaved as if false.

Returns: string

Definition at line 3477 of file Language.php.

References removeBadCharFirst(), removeBadCharLast(), and wfMessage().

◆ truncate_endBracket()

Language::truncate_endBracket	(	&	$tag,
			$tagType,
			$lastCh,
		&	$openTags
	)

private

truncateHtml() helper function (a) push or pop $tag from $openTags as needed (b) clear $tag value

Parameters

string	&$tag	Current HTML tag name we are looking at
int	$tagType	(0-open tag, 1-close tag)
string	$lastCh	Character before the '>' that ended this tag
array	&$openTags	Open tag stack (not accounting for $tag)

Definition at line 3719 of file Language.php.

References $tag.

Referenced by truncateHtml().

◆ truncate_skip()

Language::truncate_skip	(	&	$ret,
			$text,
			$search,
			$start,
			$len = `null`
	)

private

truncateHtml() helper function like strcspn() but adds the skipped chars to $ret

Parameters

string	$ret
string	$text
string	$search
int	$start
null \| int	$len

Returns: int

Definition at line 3696 of file Language.php.

References $ret.

Referenced by truncateHtml().

◆ truncateHtml()

Language::truncateHtml	(	$text,
		$length,
		$ellipsis = `'...'`
	)

Truncate a string of valid HTML to a specified length in bytes, appending an optional string (e.g.

for ellipses), and return valid HTML

This is only intended for styled/linked text, such as HTML with tags like and , were the tags are self-contained (valid HTML). Also, this will not detect things like "display:none" CSS.

Note: since 1.18 you do not need to leave extra room in $length for ellipses.

Parameters

string	$text	HTML string to truncate
int	$length	(zero/positive) Maximum length (including ellipses)
string	$ellipsis	String to append to the truncated text

Returns: string

Definition at line 3578 of file Language.php.

References $ret, $tag, list, removeBadCharLast(), truncate_endBracket(), truncate_skip(), and wfMessage().

◆ tsToHebrew()

static Language::tsToHebrew ( $ts )

staticprivate

Converting Gregorian dates to Hebrew dates.

Based on a JavaScript code by Abu Mami and Yisrael Hersch (abu-m.nosp@m.ami@.nosp@m.kalua.nosp@m.ch.n.nosp@m.et, http://www.kaluach.net), who permitted to translate the relevant functions into PHP and release them under GNU GPL.

The months are counted from Tishrei = 1. In a leap year, Adar I is 13 and Adar II is 14. In a non-leap year, Adar is 6.

Parameters

string $ts

Returns: int[]

Definition at line 1668 of file Language.php.

References $i.

◆ tsToHijri()

static Language::tsToHijri ( $ts )

staticprivate

Converting Gregorian dates to Hijri dates.

Based on a PHP-Nuke block by Sharjeel which is released under GNU/GPL license

See also: http://phpnuke.org/modules.php?name=News&file=article&sid=8234&mode=thread&order=0&thold=0

Parameters

string $ts

Returns: int[]

Definition at line 1616 of file Language.php.

◆ tsToIranian()

static Language::tsToIranian ( $ts )

staticprivate

Algorithm by Roozbeh Pournader and Mohammad Toossi to convert Gregorian dates to Iranian dates.

Originally written in C, it is released under the terms of GNU Lesser General Public License. Conversion to PHP was performed by Niklas Laxström.

Link: http://www.farsiweb.info/jalali/jalali.c

Parameters

string $ts

Returns: int[]

Definition at line 1558 of file Language.php.

References $i.

◆ tsToYear()

static Language::tsToYear	(	$ts,
		$cName
	)

staticprivate

Algorithm to convert Gregorian dates to Thai solar dates, Minguo dates or Minguo dates.

Link: http://en.wikipedia.org/wiki/Thai_solar_calendar http://en.wikipedia.org/wiki/Minguo_calendar http://en.wikipedia.org/wiki/Japanese_era_name

Parameters

string	$ts	14-character timestamp
string	$cName	Calender name

Returns: array Converted year, month, day

Definition at line 1847 of file Language.php.

◆ uc()

Language::uc	(	$str,
		$first = `false`
	)

Convert a string to uppercase.

Parameters

string	$str
bool	$first

Returns: string

Definition at line 2656 of file Language.php.

References isMultibyte(), and ucfirst().

Referenced by caseFold(), and ucfirst().

◆ ucfirst()

Language::ucfirst ( $str )

Make a string's first character uppercase.

Parameters

string $str

Returns: string

Reimplemented in LanguageAz, LanguageKaa, LanguageKk, and LanguageTr.

Definition at line 2636 of file Language.php.

References uc(), and ucfirst().

Referenced by classFromCode(), getFileName(), uc(), ucfirst(), and ucwordbreaksCallbackAscii().

◆ ucwordbreaks()

Language::ucwordbreaks ( $str )

capitalize words at word breaks

Parameters

string $str

Returns: mixed

Definition at line 2739 of file Language.php.

References isMultibyte(), and lc().

◆ ucwordbreaksCallbackAscii()

Language::ucwordbreaksCallbackAscii ( $matches )

Parameters

array $matches

Returns: mixed|string

Definition at line 2609 of file Language.php.

References $matches, and ucfirst().

◆ ucwordbreaksCallbackMB()

Language::ucwordbreaksCallbackMB ( $matches )

Parameters

array $matches

Returns: string

Definition at line 2617 of file Language.php.

References $matches.

◆ ucwords()

Language::ucwords ( $str )

Parameters

string $str

Returns: mixed|string

Definition at line 2715 of file Language.php.

References isMultibyte(), lc(), and ucwords().

Referenced by ucwords().

◆ ucwordsCallbackMB()

Language::ucwordsCallbackMB ( $matches )

Parameters

array $matches

Returns: string

Definition at line 2625 of file Language.php.

References $matches.

◆ unsegmentForDiff()

Language::unsegmentForDiff ( $text )

and unsegment to show the result

Parameters

string $text

Returns: string

Reimplemented in LanguageZh.

Definition at line 3964 of file Language.php.

◆ updateConversionTable()

Language::updateConversionTable ( Title $title )

Refresh the cache of conversion tables when MediaWiki:Conversiontable* is updated.

Parameters

Title $title The Title of the page being updated

Definition at line 4131 of file Language.php.

References $title.

◆ userAdjust()

Language::userAdjust	(	$ts,
		$tz = `false`
	)

Used by date() and time() to adjust the time output.

Parameters

string	$ts	The time in date('YmdHis') format
mixed	$tz	Adjust the time by this amount (default false, mean we get user timecorrection setting)

Returns: int

Definition at line 2080 of file Language.php.

References $t, $wgLocalTZoffset, $wgUser, date(), and global.

Referenced by LanguageWa\date(), date(), internalUserTimeAndDate(), time(), LanguageWa\timeanddate(), and timeanddate().

◆ userDate()

Language::userDate	(		$ts,
		User	$user,
		array	$options = `[]`
	)

Get the formatted date for the given timestamp and formatted for the given user.

Parameters

mixed	$ts	Mixed: the time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts)
User	$user	User object used to get preferences for timezone and format
array	$options	Array, can contain the following keys: 'timecorrection': time correction, can have the following values: true: use user's preference false: don't use time correction int: value of time correction in minutes 'format': format to use, can have the following values: true: use user's preference false: use default preference string: format to use

Since: 1.19

Returns: string

Definition at line 2401 of file Language.php.

References $options, $user, and internalUserTimeAndDate().

◆ userTime()

Language::userTime	(		$ts,
		User	$user,
		array	$options = `[]`
	)

Get the formatted time for the given timestamp and formatted for the given user.

Parameters

mixed	$ts	The time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts)
User	$user	User object used to get preferences for timezone and format
array	$options	Array, can contain the following keys: 'timecorrection': time correction, can have the following values: true: use user's preference false: don't use time correction int: value of time correction in minutes 'format': format to use, can have the following values: true: use user's preference false: use default preference string: format to use

Since: 1.19

Returns: string

Definition at line 2424 of file Language.php.

References $options, $user, and internalUserTimeAndDate().

◆ userTimeAndDate()

Language::userTimeAndDate	(		$ts,
		User	$user,
		array	$options = `[]`
	)

Get the formatted date and time for the given timestamp and formatted for the given user.

Parameters

mixed	$ts	The time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts)
User	$user	User object used to get preferences for timezone and format
array	$options	Array, can contain the following keys: 'timecorrection': time correction, can have the following values: true: use user's preference false: don't use time correction int: value of time correction in minutes 'format': format to use, can have the following values: true: use user's preference false: use default preference string: format to use

Since: 1.19

Returns: string

Definition at line 2447 of file Language.php.

References $options, $user, and internalUserTimeAndDate().

Referenced by translateBlockExpiry().

◆ viewPrevNext()

Language::viewPrevNext	(	Title	$title,
			$offset,
			$limit,
		array	$query = `[]`,
			$atend = `false`
	)

Generate (prev x| next x) (20|50|100...) type links for paging.

Parameters

Title	$title	Title object to link
int	$offset
int	$limit
array	$query	Optional URL query parameter string
bool	$atend	Optional param for specified if this is the last page

Returns: string

Definition at line 4664 of file Language.php.

References $limit, $query, $title, as, formatNum(), numLink(), pipeList(), and wfMessage().

Member Data Documentation

◆ $dataCache

LocalisationCache Language::$dataCache

static

Definition at line 62 of file Language.php.

◆ $dateFormatStrings

Language::$dateFormatStrings = []

Definition at line 49 of file Language.php.

◆ $durationIntervals

array Language::$durationIntervals

static

Initial value:

= [
        'millennia' => 31556952000,
        'centuries' => 3155695200,
        'decades' => 315569520,
        'years' => 31556952, 
        'weeks' => 604800,
        'days' => 86400,
        'hours' => 3600,
        'minutes' => 60,
        'seconds' => 1,
    ]

Since: 1.20

Definition at line 124 of file Language.php.

◆ $fallbackLanguageCache

array Language::$fallbackLanguageCache = []

staticprivate

Cache for language fallbacks.

See also: Language::getFallbacksIncludingSiteLanguage

Since: 1.21

Definition at line 142 of file Language.php.

◆ $GREG_DAYS

Language::$GREG_DAYS = [ 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 ]

staticprivate

Definition at line 1543 of file Language.php.

◆ $IRANIAN_DAYS

Language::$IRANIAN_DAYS = [ 31, 31, 31, 31, 31, 31, 30, 30, 30, 30, 30, 29 ]

staticprivate

Definition at line 1544 of file Language.php.

◆ $languageNameCache

HashBagOStuff null Language::$languageNameCache

staticprivate

Cache for language names.

Definition at line 148 of file Language.php.

◆ $lre

Language::$lre = "\xE2\x80\xAA"

staticprivate

Unicode directional formatting characters, for embedBidi()

Definition at line 153 of file Language.php.

◆ $mCode

Language::$mCode

Definition at line 45 of file Language.php.

◆ $mConverter

LanguageConverter Language::$mConverter

Definition at line 43 of file Language.php.

◆ $mExtendedSpecialPageAliases

Language::$mExtendedSpecialPageAliases

Definition at line 50 of file Language.php.

◆ $mHebrewCalendarMonthGenMsgs

Language::$mHebrewCalendarMonthGenMsgs

static

Initial value:

= [
        'hebrew-calendar-m1-gen', 'hebrew-calendar-m2-gen', 'hebrew-calendar-m3-gen',
        'hebrew-calendar-m4-gen', 'hebrew-calendar-m5-gen', 'hebrew-calendar-m6-gen',
        'hebrew-calendar-m7-gen', 'hebrew-calendar-m8-gen', 'hebrew-calendar-m9-gen',
        'hebrew-calendar-m10-gen', 'hebrew-calendar-m11-gen', 'hebrew-calendar-m12-gen',
        'hebrew-calendar-m6a-gen', 'hebrew-calendar-m6b-gen'
    ]

Definition at line 105 of file Language.php.

◆ $mHebrewCalendarMonthMsgs

Language::$mHebrewCalendarMonthMsgs

static

Initial value:

= [
        'hebrew-calendar-m1', 'hebrew-calendar-m2', 'hebrew-calendar-m3',
        'hebrew-calendar-m4', 'hebrew-calendar-m5', 'hebrew-calendar-m6',
        'hebrew-calendar-m7', 'hebrew-calendar-m8', 'hebrew-calendar-m9',
        'hebrew-calendar-m10', 'hebrew-calendar-m11', 'hebrew-calendar-m12',
        'hebrew-calendar-m6a', 'hebrew-calendar-m6b'
    ]

Definition at line 97 of file Language.php.

◆ $mHijriCalendarMonthMsgs

Language::$mHijriCalendarMonthMsgs

static

Initial value:

= [
        'hijri-calendar-m1', 'hijri-calendar-m2', 'hijri-calendar-m3',
        'hijri-calendar-m4', 'hijri-calendar-m5', 'hijri-calendar-m6',
        'hijri-calendar-m7', 'hijri-calendar-m8', 'hijri-calendar-m9',
        'hijri-calendar-m10', 'hijri-calendar-m11', 'hijri-calendar-m12'
    ]

Definition at line 113 of file Language.php.

◆ $mHtmlCode

Language::$mHtmlCode = null

private

Definition at line 47 of file Language.php.

◆ $mIranianCalendarMonthMsgs

Language::$mIranianCalendarMonthMsgs

static

Initial value:

= [
        'iranian-calendar-m1', 'iranian-calendar-m2', 'iranian-calendar-m3',
        'iranian-calendar-m4', 'iranian-calendar-m5', 'iranian-calendar-m6',
        'iranian-calendar-m7', 'iranian-calendar-m8', 'iranian-calendar-m9',
        'iranian-calendar-m10', 'iranian-calendar-m11', 'iranian-calendar-m12'
    ]

Definition at line 90 of file Language.php.

◆ $mLangObjCache

Language::$mLangObjCache = []

static

Definition at line 64 of file Language.php.

◆ $mLoaded

Language::$mLoaded = false

Definition at line 45 of file Language.php.

◆ $mMagicExtensions

Language::$mMagicExtensions = []

Definition at line 46 of file Language.php.

◆ $mMagicHookDone

Language::$mMagicHookDone = false

Definition at line 46 of file Language.php.

◆ $mMonthAbbrevMsgs

Language::$mMonthAbbrevMsgs

static

Initial value:

= [
        'jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug',
        'sep', 'oct', 'nov', 'dec'
    ]

Definition at line 85 of file Language.php.

◆ $mMonthGenMsgs

Language::$mMonthGenMsgs

static

Initial value:

= [
        'january-gen', 'february-gen', 'march-gen', 'april-gen', 'may-gen', 'june-gen',
        'july-gen', 'august-gen', 'september-gen', 'october-gen', 'november-gen',
        'december-gen'
    ]

Definition at line 80 of file Language.php.

◆ $mMonthMsgs

Language::$mMonthMsgs

static

Initial value:

= [
        'january', 'february', 'march', 'april', 'may_long', 'june',
        'july', 'august', 'september', 'october', 'november',
        'december'
    ]

Definition at line 75 of file Language.php.

◆ $mNamespaceIds

Language::$mNamespaceIds

protected

Definition at line 52 of file Language.php.

◆ $mParentLanguage

Language::$mParentLanguage = false

private

Definition at line 47 of file Language.php.

◆ $mVariants

Language::$mVariants

Definition at line 45 of file Language.php.

◆ $mWeekdayAbbrevMsgs

Language::$mWeekdayAbbrevMsgs

static

Initial value:

= [
        'sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'
    ]

Definition at line 71 of file Language.php.

◆ $mWeekdayMsgs

Language::$mWeekdayMsgs

static

Initial value:

= [
        'sunday', 'monday', 'tuesday', 'wednesday', 'thursday',
        'friday', 'saturday'
    ]

Definition at line 66 of file Language.php.

◆ $namespaceAliases

Language::$namespaceAliases

protected

Definition at line 52 of file Language.php.

◆ $namespaceNames

Language::$namespaceNames

protected

Definition at line 52 of file Language.php.

◆ $pdf

Language::$pdf = "\xE2\x80\xAC"

staticprivate

Definition at line 155 of file Language.php.

◆ $rle

Language::$rle = "\xE2\x80\xAB"

staticprivate

Definition at line 154 of file Language.php.

◆ $strongDirRegex

Language::$strongDirRegex = '/(?:([\x{41}-\x{5a}\x{61}-\x{7a}\x{aa}\x{b5}\x{ba}\x{c0}-\x{d6}\x{d8}-\x{f6}\x{f8}-\x{2b8}\x{2bb}-\x{2c1}\x{2d0}\x{2d1}\x{2e0}-\x{2e4}\x{2ee}\x{370}-\x{373}\x{376}\x{377}\x{37a}-\x{37d}\x{37f}\x{386}\x{388}-\x{38a}\x{38c}\x{38e}-\x{3a1}\x{3a3}-\x{3f5}\x{3f7}-\x{482}\x{48a}-\x{52f}\x{531}-\x{556}\x{559}-\x{55f}\x{561}-\x{587}\x{589}\x{903}-\x{939}\x{93b}\x{93d}-\x{940}\x{949}-\x{94c}\x{94e}-\x{950}\x{958}-\x{961}\x{964}-\x{980}\x{982}\x{983}\x{985}-\x{98c}\x{98f}\x{990}\x{993}-\x{9a8}\x{9aa}-\x{9b0}\x{9b2}\x{9b6}-\x{9b9}\x{9bd}-\x{9c0}\x{9c7}\x{9c8}\x{9cb}\x{9cc}\x{9ce}\x{9d7}\x{9dc}\x{9dd}\x{9df}-\x{9e1}\x{9e6}-\x{9f1}\x{9f4}-\x{9fa}\x{a03}\x{a05}-\x{a0a}\x{a0f}\x{a10}\x{a13}-\x{a28}\x{a2a}-\x{a30}\x{a32}\x{a33}\x{a35}\x{a36}\x{a38}\x{a39}\x{a3e}-\x{a40}\x{a59}-\x{a5c}\x{a5e}\x{a66}-\x{a6f}\x{a72}-\x{a74}\x{a83}\x{a85}-\x{a8d}\x{a8f}-\x{a91}\x{a93}-\x{aa8}\x{aaa}-\x{ab0}\x{ab2}\x{ab3}\x{ab5}-\x{ab9}\x{abd}-\x{ac0}\x{ac9}\x{acb}\x{acc}\x{ad0}\x{ae0}\x{ae1}\x{ae6}-\x{af0}\x{af9}\x{b02}\x{b03}\x{b05}-\x{b0c}\x{b0f}\x{b10}\x{b13}-\x{b28}\x{b2a}-\x{b30}\x{b32}\x{b33}\x{b35}-\x{b39}\x{b3d}\x{b3e}\x{b40}\x{b47}\x{b48}\x{b4b}\x{b4c}\x{b57}\x{b5c}\x{b5d}\x{b5f}-\x{b61}\x{b66}-\x{b77}\x{b83}\x{b85}-\x{b8a}\x{b8e}-\x{b90}\x{b92}-\x{b95}\x{b99}\x{b9a}\x{b9c}\x{b9e}\x{b9f}\x{ba3}\x{ba4}\x{ba8}-\x{baa}\x{bae}-\x{bb9}\x{bbe}\x{bbf}\x{bc1}\x{bc2}\x{bc6}-\x{bc8}\x{bca}-\x{bcc}\x{bd0}\x{bd7}\x{be6}-\x{bf2}\x{c01}-\x{c03}\x{c05}-\x{c0c}\x{c0e}-\x{c10}\x{c12}-\x{c28}\x{c2a}-\x{c39}\x{c3d}\x{c41}-\x{c44}\x{c58}-\x{c5a}\x{c60}\x{c61}\x{c66}-\x{c6f}\x{c7f}\x{c82}\x{c83}\x{c85}-\x{c8c}\x{c8e}-\x{c90}\x{c92}-\x{ca8}\x{caa}-\x{cb3}\x{cb5}-\x{cb9}\x{cbd}-\x{cc4}\x{cc6}-\x{cc8}\x{cca}\x{ccb}\x{cd5}\x{cd6}\x{cde}\x{ce0}\x{ce1}\x{ce6}-\x{cef}\x{cf1}\x{cf2}\x{d02}\x{d03}\x{d05}-\x{d0c}\x{d0e}-\x{d10}\x{d12}-\x{d3a}\x{d3d}-\x{d40}\x{d46}-\x{d48}\x{d4a}-\x{d4c}\x{d4e}\x{d57}\x{d5f}-\x{d61}\x{d66}-\x{d75}\x{d79}-\x{d7f}\x{d82}\x{d83}\x{d85}-\x{d96}\x{d9a}-\x{db1}\x{db3}-\x{dbb}\x{dbd}\x{dc0}-\x{dc6}\x{dcf}-\x{dd1}\x{dd8}-\x{ddf}\x{de6}-\x{def}\x{df2}-\x{df4}\x{e01}-\x{e30}\x{e32}\x{e33}\x{e40}-\x{e46}\x{e4f}-\x{e5b}\x{e81}\x{e82}\x{e84}\x{e87}\x{e88}\x{e8a}\x{e8d}\x{e94}-\x{e97}\x{e99}-\x{e9f}\x{ea1}-\x{ea3}\x{ea5}\x{ea7}\x{eaa}\x{eab}\x{ead}-\x{eb0}\x{eb2}\x{eb3}\x{ebd}\x{ec0}-\x{ec4}\x{ec6}\x{ed0}-\x{ed9}\x{edc}-\x{edf}\x{f00}-\x{f17}\x{f1a}-\x{f34}\x{f36}\x{f38}\x{f3e}-\x{f47}\x{f49}-\x{f6c}\x{f7f}\x{f85}\x{f88}-\x{f8c}\x{fbe}-\x{fc5}\x{fc7}-\x{fcc}\x{fce}-\x{fda}\x{1000}-\x{102c}\x{1031}\x{1038}\x{103b}\x{103c}\x{103f}-\x{1057}\x{105a}-\x{105d}\x{1061}-\x{1070}\x{1075}-\x{1081}\x{1083}\x{1084}\x{1087}-\x{108c}\x{108e}-\x{109c}\x{109e}-\x{10c5}\x{10c7}\x{10cd}\x{10d0}-\x{1248}\x{124a}-\x{124d}\x{1250}-\x{1256}\x{1258}\x{125a}-\x{125d}\x{1260}-\x{1288}\x{128a}-\x{128d}\x{1290}-\x{12b0}\x{12b2}-\x{12b5}\x{12b8}-\x{12be}\x{12c0}\x{12c2}-\x{12c5}\x{12c8}-\x{12d6}\x{12d8}-\x{1310}\x{1312}-\x{1315}\x{1318}-\x{135a}\x{1360}-\x{137c}\x{1380}-\x{138f}\x{13a0}-\x{13f5}\x{13f8}-\x{13fd}\x{1401}-\x{167f}\x{1681}-\x{169a}\x{16a0}-\x{16f8}\x{1700}-\x{170c}\x{170e}-\x{1711}\x{1720}-\x{1731}\x{1735}\x{1736}\x{1740}-\x{1751}\x{1760}-\x{176c}\x{176e}-\x{1770}\x{1780}-\x{17b3}\x{17b6}\x{17be}-\x{17c5}\x{17c7}\x{17c8}\x{17d4}-\x{17da}\x{17dc}\x{17e0}-\x{17e9}\x{1810}-\x{1819}\x{1820}-\x{1877}\x{1880}-\x{18a8}\x{18aa}\x{18b0}-\x{18f5}\x{1900}-\x{191e}\x{1923}-\x{1926}\x{1929}-\x{192b}\x{1930}\x{1931}\x{1933}-\x{1938}\x{1946}-\x{196d}\x{1970}-\x{1974}\x{1980}-\x{19ab}\x{19b0}-\x{19c9}\x{19d0}-\x{19da}\x{1a00}-\x{1a16}\x{1a19}\x{1a1a}\x{1a1e}-\x{1a55}\x{1a57}\x{1a61}\x{1a63}\x{1a64}\x{1a6d}-\x{1a72}\x{1a80}-\x{1a89}\x{1a90}-\x{1a99}\x{1aa0}-\x{1aad}\x{1b04}-\x{1b33}\x{1b35}\x{1b3b}\x{1b3d}-\x{1b41}\x{1b43}-\x{1b4b}\x{1b50}-\x{1b6a}\x{1b74}-\x{1b7c}\x{1b82}-\x{1ba1}\x{1ba6}\x{1ba7}\x{1baa}\x{1bae}-\x{1be5}\x{1be7}\x{1bea}-\x{1bec}\x{1bee}\x{1bf2}\x{1bf3}\x{1bfc}-\x{1c2b}\x{1c34}\x{1c35}\x{1c3b}-\x{1c49}\x{1c4d}-\x{1c7f}\x{1cc0}-\x{1cc7}\x{1cd3}\x{1ce1}\x{1ce9}-\x{1cec}\x{1cee}-\x{1cf3}\x{1cf5}\x{1cf6}\x{1d00}-\x{1dbf}\x{1e00}-\x{1f15}\x{1f18}-\x{1f1d}\x{1f20}-\x{1f45}\x{1f48}-\x{1f4d}\x{1f50}-\x{1f57}\x{1f59}\x{1f5b}\x{1f5d}\x{1f5f}-\x{1f7d}\x{1f80}-\x{1fb4}\x{1fb6}-\x{1fbc}\x{1fbe}\x{1fc2}-\x{1fc4}\x{1fc6}-\x{1fcc}\x{1fd0}-\x{1fd3}\x{1fd6}-\x{1fdb}\x{1fe0}-\x{1fec}\x{1ff2}-\x{1ff4}\x{1ff6}-\x{1ffc}\x{200e}\x{2071}\x{207f}\x{2090}-\x{209c}\x{2102}\x{2107}\x{210a}-\x{2113}\x{2115}\x{2119}-\x{211d}\x{2124}\x{2126}\x{2128}\x{212a}-\x{212d}\x{212f}-\x{2139}\x{213c}-\x{213f}\x{2145}-\x{2149}\x{214e}\x{214f}\x{2160}-\x{2188}\x{2336}-\x{237a}\x{2395}\x{249c}-\x{24e9}\x{26ac}\x{2800}-\x{28ff}\x{2c00}-\x{2c2e}\x{2c30}-\x{2c5e}\x{2c60}-\x{2ce4}\x{2ceb}-\x{2cee}\x{2cf2}\x{2cf3}\x{2d00}-\x{2d25}\x{2d27}\x{2d2d}\x{2d30}-\x{2d67}\x{2d6f}\x{2d70}\x{2d80}-\x{2d96}\x{2da0}-\x{2da6}\x{2da8}-\x{2dae}\x{2db0}-\x{2db6}\x{2db8}-\x{2dbe}\x{2dc0}-\x{2dc6}\x{2dc8}-\x{2dce}\x{2dd0}-\x{2dd6}\x{2dd8}-\x{2dde}\x{3005}-\x{3007}\x{3021}-\x{3029}\x{302e}\x{302f}\x{3031}-\x{3035}\x{3038}-\x{303c}\x{3041}-\x{3096}\x{309d}-\x{309f}\x{30a1}-\x{30fa}\x{30fc}-\x{30ff}\x{3105}-\x{312d}\x{3131}-\x{318e}\x{3190}-\x{31ba}\x{31f0}-\x{321c}\x{3220}-\x{324f}\x{3260}-\x{327b}\x{327f}-\x{32b0}\x{32c0}-\x{32cb}\x{32d0}-\x{32fe}\x{3300}-\x{3376}\x{337b}-\x{33dd}\x{33e0}-\x{33fe}\x{3400}-\x{4db5}\x{4e00}-\x{9fd5}\x{a000}-\x{a48c}\x{a4d0}-\x{a60c}\x{a610}-\x{a62b}\x{a640}-\x{a66e}\x{a680}-\x{a69d}\x{a6a0}-\x{a6ef}\x{a6f2}-\x{a6f7}\x{a722}-\x{a787}\x{a789}-\x{a7ad}\x{a7b0}-\x{a7b7}\x{a7f7}-\x{a801}\x{a803}-\x{a805}\x{a807}-\x{a80a}\x{a80c}-\x{a824}\x{a827}\x{a830}-\x{a837}\x{a840}-\x{a873}\x{a880}-\x{a8c3}\x{a8ce}-\x{a8d9}\x{a8f2}-\x{a8fd}\x{a900}-\x{a925}\x{a92e}-\x{a946}\x{a952}\x{a953}\x{a95f}-\x{a97c}\x{a983}-\x{a9b2}\x{a9b4}\x{a9b5}\x{a9ba}\x{a9bb}\x{a9bd}-\x{a9cd}\x{a9cf}-\x{a9d9}\x{a9de}-\x{a9e4}\x{a9e6}-\x{a9fe}\x{aa00}-\x{aa28}\x{aa2f}\x{aa30}\x{aa33}\x{aa34}\x{aa40}-\x{aa42}\x{aa44}-\x{aa4b}\x{aa4d}\x{aa50}-\x{aa59}\x{aa5c}-\x{aa7b}\x{aa7d}-\x{aaaf}\x{aab1}\x{aab5}\x{aab6}\x{aab9}-\x{aabd}\x{aac0}\x{aac2}\x{aadb}-\x{aaeb}\x{aaee}-\x{aaf5}\x{ab01}-\x{ab06}\x{ab09}-\x{ab0e}\x{ab11}-\x{ab16}\x{ab20}-\x{ab26}\x{ab28}-\x{ab2e}\x{ab30}-\x{ab65}\x{ab70}-\x{abe4}\x{abe6}\x{abe7}\x{abe9}-\x{abec}\x{abf0}-\x{abf9}\x{ac00}-\x{d7a3}\x{d7b0}-\x{d7c6}\x{d7cb}-\x{d7fb}\x{e000}-\x{fa6d}\x{fa70}-\x{fad9}\x{fb00}-\x{fb06}\x{fb13}-\x{fb17}\x{ff21}-\x{ff3a}\x{ff41}-\x{ff5a}\x{ff66}-\x{ffbe}\x{ffc2}-\x{ffc7}\x{ffca}-\x{ffcf}\x{ffd2}-\x{ffd7}\x{ffda}-\x{ffdc}\x{10000}-\x{1000b}\x{1000d}-\x{10026}\x{10028}-\x{1003a}\x{1003c}\x{1003d}\x{1003f}-\x{1004d}\x{10050}-\x{1005d}\x{10080}-\x{100fa}\x{10100}\x{10102}\x{10107}-\x{10133}\x{10137}-\x{1013f}\x{101d0}-\x{101fc}\x{10280}-\x{1029c}\x{102a0}-\x{102d0}\x{10300}-\x{10323}\x{10330}-\x{1034a}\x{10350}-\x{10375}\x{10380}-\x{1039d}\x{1039f}-\x{103c3}\x{103c8}-\x{103d5}\x{10400}-\x{1049d}\x{104a0}-\x{104a9}\x{10500}-\x{10527}\x{10530}-\x{10563}\x{1056f}\x{10600}-\x{10736}\x{10740}-\x{10755}\x{10760}-\x{10767}\x{11000}\x{11002}-\x{11037}\x{11047}-\x{1104d}\x{11066}-\x{1106f}\x{11082}-\x{110b2}\x{110b7}\x{110b8}\x{110bb}-\x{110c1}\x{110d0}-\x{110e8}\x{110f0}-\x{110f9}\x{11103}-\x{11126}\x{1112c}\x{11136}-\x{11143}\x{11150}-\x{11172}\x{11174}-\x{11176}\x{11182}-\x{111b5}\x{111bf}-\x{111c9}\x{111cd}\x{111d0}-\x{111df}\x{111e1}-\x{111f4}\x{11200}-\x{11211}\x{11213}-\x{1122e}\x{11232}\x{11233}\x{11235}\x{11238}-\x{1123d}\x{11280}-\x{11286}\x{11288}\x{1128a}-\x{1128d}\x{1128f}-\x{1129d}\x{1129f}-\x{112a9}\x{112b0}-\x{112de}\x{112e0}-\x{112e2}\x{112f0}-\x{112f9}\x{11302}\x{11303}\x{11305}-\x{1130c}\x{1130f}\x{11310}\x{11313}-\x{11328}\x{1132a}-\x{11330}\x{11332}\x{11333}\x{11335}-\x{11339}\x{1133d}-\x{1133f}\x{11341}-\x{11344}\x{11347}\x{11348}\x{1134b}-\x{1134d}\x{11350}\x{11357}\x{1135d}-\x{11363}\x{11480}-\x{114b2}\x{114b9}\x{114bb}-\x{114be}\x{114c1}\x{114c4}-\x{114c7}\x{114d0}-\x{114d9}\x{11580}-\x{115b1}\x{115b8}-\x{115bb}\x{115be}\x{115c1}-\x{115db}\x{11600}-\x{11632}\x{1163b}\x{1163c}\x{1163e}\x{11641}-\x{11644}\x{11650}-\x{11659}\x{11680}-\x{116aa}\x{116ac}\x{116ae}\x{116af}\x{116b6}\x{116c0}-\x{116c9}\x{11700}-\x{11719}\x{11720}\x{11721}\x{11726}\x{11730}-\x{1173f}\x{118a0}-\x{118f2}\x{118ff}\x{11ac0}-\x{11af8}\x{12000}-\x{12399}\x{12400}-\x{1246e}\x{12470}-\x{12474}\x{12480}-\x{12543}\x{13000}-\x{1342e}\x{14400}-\x{14646}\x{16800}-\x{16a38}\x{16a40}-\x{16a5e}\x{16a60}-\x{16a69}\x{16a6e}\x{16a6f}\x{16ad0}-\x{16aed}\x{16af5}\x{16b00}-\x{16b2f}\x{16b37}-\x{16b45}\x{16b50}-\x{16b59}\x{16b5b}-\x{16b61}\x{16b63}-\x{16b77}\x{16b7d}-\x{16b8f}\x{16f00}-\x{16f44}\x{16f50}-\x{16f7e}\x{16f93}-\x{16f9f}\x{1b000}\x{1b001}\x{1bc00}-\x{1bc6a}\x{1bc70}-\x{1bc7c}\x{1bc80}-\x{1bc88}\x{1bc90}-\x{1bc99}\x{1bc9c}\x{1bc9f}\x{1d000}-\x{1d0f5}\x{1d100}-\x{1d126}\x{1d129}-\x{1d166}\x{1d16a}-\x{1d172}\x{1d183}\x{1d184}\x{1d18c}-\x{1d1a9}\x{1d1ae}-\x{1d1e8}\x{1d360}-\x{1d371}\x{1d400}-\x{1d454}\x{1d456}-\x{1d49c}\x{1d49e}\x{1d49f}\x{1d4a2}\x{1d4a5}\x{1d4a6}\x{1d4a9}-\x{1d4ac}\x{1d4ae}-\x{1d4b9}\x{1d4bb}\x{1d4bd}-\x{1d4c3}\x{1d4c5}-\x{1d505}\x{1d507}-\x{1d50a}\x{1d50d}-\x{1d514}\x{1d516}-\x{1d51c}\x{1d51e}-\x{1d539}\x{1d53b}-\x{1d53e}\x{1d540}-\x{1d544}\x{1d546}\x{1d54a}-\x{1d550}\x{1d552}-\x{1d6a5}\x{1d6a8}-\x{1d6da}\x{1d6dc}-\x{1d714}\x{1d716}-\x{1d74e}\x{1d750}-\x{1d788}\x{1d78a}-\x{1d7c2}\x{1d7c4}-\x{1d7cb}\x{1d800}-\x{1d9ff}\x{1da37}-\x{1da3a}\x{1da6d}-\x{1da74}\x{1da76}-\x{1da83}\x{1da85}-\x{1da8b}\x{1f110}-\x{1f12e}\x{1f130}-\x{1f169}\x{1f170}-\x{1f19a}\x{1f1e6}-\x{1f202}\x{1f210}-\x{1f23a}\x{1f240}-\x{1f248}\x{1f250}\x{1f251}\x{20000}-\x{2a6d6}\x{2a700}-\x{2b734}\x{2b740}-\x{2b81d}\x{2b820}-\x{2cea1}\x{2f800}-\x{2fa1d}\x{f0000}-\x{ffffd}\x{100000}-\x{10fffd}])|([\x{590}\x{5be}\x{5c0}\x{5c3}\x{5c6}\x{5c8}-\x{5ff}\x{7c0}-\x{7ea}\x{7f4}\x{7f5}\x{7fa}-\x{815}\x{81a}\x{824}\x{828}\x{82e}-\x{858}\x{85c}-\x{89f}\x{200f}\x{fb1d}\x{fb1f}-\x{fb28}\x{fb2a}-\x{fb4f}\x{10800}-\x{1091e}\x{10920}-\x{10a00}\x{10a04}\x{10a07}-\x{10a0b}\x{10a10}-\x{10a37}\x{10a3b}-\x{10a3e}\x{10a40}-\x{10ae4}\x{10ae7}-\x{10b38}\x{10b40}-\x{10e5f}\x{10e7f}-\x{10fff}\x{1e800}-\x{1e8cf}\x{1e8d7}-\x{1edff}\x{1ef00}-\x{1efff}\x{608}\x{60b}\x{60d}\x{61b}-\x{64a}\x{66d}-\x{66f}\x{671}-\x{6d5}\x{6e5}\x{6e6}\x{6ee}\x{6ef}\x{6fa}-\x{710}\x{712}-\x{72f}\x{74b}-\x{7a5}\x{7b1}-\x{7bf}\x{8a0}-\x{8e2}\x{fb50}-\x{fd3d}\x{fd40}-\x{fdcf}\x{fdf0}-\x{fdfc}\x{fdfe}\x{fdff}\x{fe70}-\x{fefe}\x{1ee00}-\x{1eeef}\x{1eef2}-\x{1eeff}]))/u'

staticprivate

Directionality test regex for embedBidi().

Matches the first strong directionality codepoint:

in group 1 if it is LTR
in group 2 if it is RTL Does not match if there is no strong directionality codepoint.

The form is '/(?:([strong ltr codepoint])|([strong rtl codepoint]))/u' .

Generated by UnicodeJS (see tools/strongDir) from the UCD; see https://git.wikimedia.org/summary/unicodejs.git .

Definition at line 170 of file Language.php.

◆ $transformData

Language::$transformData = []

ReplacementArray object caches.

Definition at line 57 of file Language.php.

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

languages/Language.php

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

◆ __destruct()

Member Function Documentation

◆ addMagicWordsByLang()

◆ alignEnd()

◆ alignStart()

◆ autoConvertToAllVariants()

◆ capitalizeAllNouns()

◆ caseFold()

◆ checkTitleEncoding()

◆ classFromCode()

◆ commafy()

◆ commaList()

◆ convert()

◆ convertCategoryKey()

◆ convertDoubleWidth()

◆ convertForSearchResult()

◆ convertGrammar()

◆ convertHtml()

◆ convertNamespace()

◆ convertPlural()

◆ convertTitle()

◆ date()

◆ dateFormat()

◆ dateTimeObjFormat()

◆ digitGroupingPattern()

◆ digitTransformTable()

◆ doMagicHook()

◆ embedBidi()

◆ emphasize()

◆ factory()

◆ fallback8bitEncoding()

◆ fetchLanguageName()

◆ fetchLanguageNames()

◆ fetchLanguageNamesUncached()

◆ findVariantLink()

◆ firstChar()

◆ fixVariableInNamespace()

◆ formatBitrate()

◆ formatComputingNumbers()

◆ formatDuration()

◆ formatExpiry()

◆ formatNum()

◆ formatNumNoSeparators()

◆ formatSize()

◆ formatTimePeriod()

◆ gender()

◆ getAllMessages()

◆ getArrow()

◆ getBookstoreList()

◆ getCode()

◆ getCodeFromFileName()

◆ getCompiledPluralRules()

◆ getConverter()

◆ getConvRuleTitle()

◆ getDateFormats()

◆ getDateFormatString()

◆ getDatePreferenceMigrationMap()

◆ getDatePreferences()

◆ getDefaultDateFormat()

◆ getDefaultVariant()

◆ getDir()

◆ getDirMark()

◆ getDirMarkEntity()

◆ getDurationIntervals()

◆ getExtraHashOptions()

◆ getExtraUserToggles()