LanguageZh Class Reference
class that handles both Traditional and Simplified Chinese right now it only distinguish zh_hans, zh_hant, zh_cn, zh_tw, zh_sg and zh_hk. More...
Inheritance diagram for LanguageZh:
Collaboration diagram for LanguageZh:
Public Member Functions | |
| __construct () | |
| convertForSearchResult ( $termsArray) | |
| normalizeForSearch ( $string, $autoVariant='zh-hans') | |
| auto convert to zh-hans and normalize special characters. More... | |
| segmentForDiff ( $text) | |
| this should give much better diff info More... | |
| unsegmentForDiff ( $text) | |
 Public Member Functions inherited from LanguageZh_hans | |
| formatDuration ( $seconds, array $chosenIntervals=[]) | |
| Takes a number of seconds and turns it into a text using values such as hours and minutes. More... | |
| hasWordBreaks () | |
| normalizeForSearch ( $s) | |
| segmentByWord ( $string) | |
| Eventually this should be a word segmentation; for now just treat each character as a word. More... | |
| Public Member Functions inherited from Language | |
| __destruct () | |
| Reduce memory usage PhanTypeSuspiciousNonTraversableForeach. More... | |
| addMagicWordsByLang ( $newWords) | |
| Add magic words to the extension array. More... | |
| alignEnd () | |
| Return 'right' or 'left' as appropriate alignment for line-end for this language's text direction. More... | |
| alignStart () | |
| Return 'left' or 'right' as appropriate alignment for line-start for this language's text direction. More... | |
| autoConvert ( $text, $variant=false) | |
| convert text to a variant More... | |
| autoConvertToAllVariants ( $text) | |
| convert text to all supported variants More... | |
| capitalizeAllNouns () | |
| caseFold ( $s) | |
| Return a case-folded representation of $s. More... | |
| checkTitleEncoding ( $s) | |
| TODO: $s is not always a string per T218883. More... | |
| commafy ( $number) | |
| Adds commas to a given number. More... | |
| commaList (array $list) | |
| Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separator message. More... | |
| convert ( $text) | |
| convert text to different variants of a language. More... | |
| convertCategoryKey ( $key) | |
| convertGrammar ( $word, $case) | |
| Grammatical transformations, needed for inflected languages Invoked by putting {{grammar:case|word}} in a message. More... | |
| convertHtml ( $text) | |
| Perform output conversion on a string, and encode for safe HTML output. More... | |
| convertNamespace ( $ns, $variant=null) | |
| Convert a namespace index to a string in the preferred variant. More... | |
| convertPlural ( $count, $forms) | |
| Plural form transformations, needed for some languages. More... | |
| convertTitle ( $title) | |
| Convert a Title object to a string in the preferred variant. More... | |
| 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. More... | |
| digitGroupingPattern () | |
| digitTransformTable () | |
| embedBidi ( $text='') | |
| Wraps argument with unicode control characters for directionality safety. More... | |
| emphasize ( $text) | |
| Italic is unsuitable for some languages. More... | |
| equals (Language $lang) | |
| Compare with an other language object. More... | |
| 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. More... | |
| firstChar ( $s) | |
| Get the first character of a string. More... | |
| 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. More... | |
| formatComputingNumbers ( $size, $boundary, $messageKey) | |
| formatExpiry ( $expiry, $format=true, $infinity='infinity') | |
| Decode an expiry (block, protection, etc) which has come from the DB. More... | |
| formatNum ( $number, $nocommafy=false) | |
| Normally we output all numbers in plain en_US style, that is 293,291.235 for twohundredninetythreethousand-twohundredninetyone point twohundredthirtyfive. More... | |
| formatNumNoSeparators ( $number) | |
| Front-end for non-commafied formatNum. More... | |
| 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. More... | |
| formatTimePeriod ( $seconds, $format=[]) | |
| Formats a time given in seconds into a string representation of that time. More... | |
| gender ( $gender, $forms) | |
| Provides an alternative text depending on specified gender. More... | |
| getAllMessages () | |
| getArrow ( $direction='forwards') | |
| An arrow, depending on the language direction. More... | |
| getBookstoreList () | |
| Exports $wgBookstoreListEn. More... | |
| getCode () | |
| Get the internal language code for this language object. More... | |
| getCompiledPluralRules () | |
| Get the compiled plural rules for the language. More... | |
| getConverter () | |
| Return the LanguageConverter used in the Language. More... | |
| getConvRuleTitle () | |
| Get the conversion rule title, if any. More... | |
| getDateFormats () | |
| getDateFormatString ( $type, $pref) | |
| Get a format string for a given type and preference. More... | |
| getDatePreferenceMigrationMap () | |
| getDatePreferences () | |
| getDefaultDateFormat () | |
| getDefaultVariant () | |
| getDir () | |
| Return the correct HTML 'dir' attribute value for this language. More... | |
| getDirMark ( $opposite=false) | |
| A hidden direction mark (LRM or RLM), depending on the language direction. More... | |
| getDirMarkEntity ( $opposite=false) | |
| A hidden direction mark (LRM or RLM), depending on the language direction. More... | |
| getDurationIntervals ( $seconds, array $chosenIntervals=[]) | |
| Takes a number of seconds and returns an array with a set of corresponding intervals. More... | |
| getExtraHashOptions () | |
| returns language specific options used by User::getPageRenderHash() for example, the preferred language variant More... | |
| getExtraUserToggles () | |
| getFallbackLanguages () | |
| getFormattedNamespaces () | |
| A convenience function that returns getNamespaces() with spaces instead of underscores in values. More... | |
| getFormattedNsText ( $index) | |
| A convenience function that returns the same thing as getNsText() except with '_' changed to ' ', useful for producing output. More... | |
| getGenderNsText ( $index, $gender) | |
| Returns gender-dependent namespace alias if available. More... | |
| getGrammarForms () | |
| Get the grammar forms for the content language. More... | |
| getGrammarTransformations () | |
| Get the grammar transformations data for the language. More... | |
| getHebrewCalendarMonthName ( $key) | |
| getHebrewCalendarMonthNameGen ( $key) | |
| getHijriCalendarMonthName ( $key) | |
| getHtmlCode () | |
| Get the code in BCP 47 format which we can use inside of html lang="" tags. More... | |
| getHumanTimestamp (MWTimestamp $time, MWTimestamp $relativeTo=null, User $user=null) | |
| Get the timestamp in a human-friendly relative format, e.g., "3 days ago". More... | |
| getIranianCalendarMonthName ( $key) | |
| getLocalNsIndex ( $text) | |
| Get a namespace key by value, case insensitive. More... | |
| getMagic ( $mw) | |
| Fill a MagicWord object with data from here. More... | |
| getMagicWords () | |
| Get all magic words from cache. More... | |
| getMessage ( $key) | |
| getMessageFromDB ( $msg) | |
| Get a message from the MediaWiki namespace. More... | |
| getMonthAbbreviation ( $key) | |
| getMonthAbbreviationsArray () | |
| getMonthName ( $key) | |
| getMonthNameGen ( $key) | |
| getMonthNamesArray () | |
| getNamespaceAliases () | |
| getNamespaceIds () | |
| getNamespaces () | |
| Returns an array of localised namespaces indexed by their numbers. More... | |
| getNsIndex ( $text) | |
| Get a namespace key by value, case insensitive. More... | |
| getNsText ( $index) | |
| Get a namespace value by key. More... | |
| getParentLanguage () | |
| Get the "parent" language which has a converter to convert a "compatible" language (in another variant) to this language (eg. More... | |
| getParsedTitle () | |
| For languages that support multiple variants, the title of an article may be displayed differently in different variants. More... | |
| getPluralRuleIndexNumber ( $number) | |
| Find the index number of the plural rule appropriate for the given number. More... | |
| getPluralRules () | |
| Get the plural rules for the language. More... | |
| 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'. More... | |
| getPluralRuleTypes () | |
| Get the plural rule types for the language. More... | |
| getPreferredVariant () | |
| getSpecialPageAliases () | |
| Get special page names, as an associative array canonical name => array of valid names, including aliases. More... | |
| getURLVariant () | |
| getUserToggle ( $tog) | |
| getVariantname ( $code, $usemsg=true) | |
| short names for language variants used for language conversion links. More... | |
| getVariants () | |
| Get the list of variants supported by this language see sample implementation in LanguageZh.php. More... | |
| getWeekdayAbbreviation ( $key) | |
| getWeekdayName ( $key) | |
| hasVariant ( $variant) | |
| Strict check if the language has the specific variant. More... | |
| hasVariants () | |
| Check if this is a language with variants. More... | |
| iconv ( $in, $out, $string) | |
| initContLang () | |
| Hook which will be called if this is the content language. More... | |
| isMultibyte ( $str) | |
| isRTL () | |
| For right-to-left language support. More... | |
| 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]]. More... | |
| linkPrefixExtension () | |
| To allow "foo[[bar]]" to extend the link over the whole word "foobar". More... | |
| linkTrail () | |
| A regular expression to match legal word-trailing characters which should be merged onto a link of the form [[foo]]bar. More... | |
| listToText (array $list) | |
| Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separator message. More... | |
| minimumGroupingDigits () | |
| needsGenderDistinction () | |
| Whether this language uses gender-dependent namespace aliases. More... | |
| normalize ( $s) | |
| Convert a UTF-8 string to normal form C. More... | |
| parseFormattedNumber ( $number) | |
| pipeList (array $list) | |
| Same as commaList, but separate it with the pipe instead. More... | |
| replaceGrammarInNamespace ( $m) | |
| resetNamespaces () | |
| Resets all of the namespace caches. More... | |
| semicolonList (array $list) | |
| Take a list of strings and build a locale-friendly semicolon-separated list, using the local semicolon-separator message. More... | |
| separatorTransformTable () | |
| setNamespaces (array $namespaces) | |
| Arbitrarily set all of the namespace names at once. More... | |
| specialList ( $page, $details, $oppositedm=true) | |
| Make a list item, used by various special pages. More... | |
| sprintfDate ( $format, $ts, DateTimeZone $zone=null, &$ttl='unused') | |
| This is a workalike of PHP's date() function, but with better internationalisation, a reduced set of format characters, and a better escaping format. More... | |
| time ( $ts, $adj=false, $format=true, $timecorrection=false) | |
| timeanddate ( $ts, $adj=false, $format=true, $timecorrection=false) | |
| translateBlockExpiry ( $str, User $user=null, $now=0) | |
| truncateForDatabase ( $string, $length, $ellipsis='...', $adjustLength=true) | |
| Truncate a string to a specified length in bytes, appending an optional string (e.g. More... | |
| truncateForVisual ( $string, $length, $ellipsis='...', $adjustLength=true) | |
| Truncate a string to a specified number of characters, appending an optional string (e.g. More... | |
| truncateHtml ( $text, $length, $ellipsis='...') | |
| Truncate a string of valid HTML to a specified length in bytes, appending an optional string (e.g. More... | |
| uc ( $str, $first=false) | |
| Convert a string to uppercase. More... | |
| ucfirst ( $str) | |
| Make a string's first character uppercase. More... | |
| ucwordbreaks ( $str) | |
| capitalize words at word breaks More... | |
| ucwordbreaksCallbackAscii ( $matches) | |
| ucwordbreaksCallbackMB ( $matches) | |
| ucwords ( $str) | |
| ucwordsCallbackMB ( $matches) | |
| updateConversionTable (Title $title) | |
| Refresh the cache of conversion tables when MediaWiki:Conversiontable* is updated. More... | |
| userAdjust ( $ts, $tz=false) | |
| Used by date() and time() to adjust the time output. More... | |
| userDate ( $ts, User $user, array $options=[]) | |
| Get the formatted date for the given timestamp and formatted for the given user. More... | |
| userTime ( $ts, User $user, array $options=[]) | |
| Get the formatted time for the given timestamp and formatted for the given user. More... | |
| userTimeAndDate ( $ts, User $user, array $options=[]) | |
| Get the formatted date and time for the given timestamp and formatted for the given user. More... | |
| viewPrevNext (Title $title, $offset, $limit, array $query=[], $atend=false) | |
| Generate (prev x| next x) (20|50|100...) type links for paging. More... | |
Additional Inherited Members | |
| Static Public Member Functions inherited from Language | |
| static | classFromCode ( $code, $fallback=true) |
| static | clearCaches () |
| Intended for tests that may change configuration in a way that invalidates caches. More... | |
| static | factory ( $code) |
| Get a cached or new language object for a given language code. More... | |
| static | fetchLanguageName ( $code, $inLanguage=self::AS_AUTONYMS, $include=self::ALL) |
| static | fetchLanguageNames ( $inLanguage=self::AS_AUTONYMS, $include='mw') |
| Get an array of language names, indexed by code. More... | |
| static | getCodeFromFileName ( $filename, $prefix='Language', $suffix='.php') |
| Get the language code from a file name. More... | |
| static | getFallbackFor ( $code) |
| Get the first fallback for a given language. More... | |
| static | getFallbacksFor ( $code, $mode=self::MESSAGES_FALLBACKS) |
| Get the ordered list of fallback languages. More... | |
| static | getFallbacksIncludingSiteLanguage ( $code) |
| Get the ordered list of fallback languages, ending with the fallback language chain for the site language. More... | |
| static | getFileName ( $prefix, $code, $suffix='.php') |
| Get the name of a file for a certain language code. More... | |
| static | getJsonMessagesFileName ( $code) |
| static | getLocalisationCache () |
| Get the LocalisationCache instance. More... | |
| static | getMessageFor ( $key, $code) |
| Get a message for a given language. More... | |
| static | getMessageKeysFor ( $code) |
| Get all message keys for a given language. More... | |
| static | getMessagesFileName ( $code) |
| static | getMessagesFor ( $code) |
| Get all messages for a given language WARNING: this may take a long time. More... | |
| static | hebrewNumeral ( $num) |
| Hebrew Gematria number formatting up to 9999. More... | |
| static | isKnownLanguageTag ( $tag) |
| Returns true if a language code is an IETF tag known to MediaWiki. More... | |
| static | isSupportedLanguage ( $code) |
| Checks whether any localisation is available for that language tag in MediaWiki (MessagesXx.php exists). More... | |
| 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. More... | |
| static | isValidCode ( $code) |
| Returns true if a language code string is of a valid form, whether or not it exists. More... | |
| static | isWellFormedLanguageTag ( $code, $lenient=false) |
| Returns true if a language code string is a well-formed language tag according to RFC 5646. More... | |
| static | romanNumeral ( $num) |
| Roman number formatting up to 10000. More... | |
| Public Attributes inherited from Language | |
| $dateFormatStrings = [] | |
| $mCode | |
| LanguageConverter FakeConverter | $mConverter |
| $mExtendedSpecialPageAliases | |
| $mLoaded = false | |
| $mMagicExtensions = [] | |
| $mVariants | |
| $namespaceAliases | |
| $transformData = [] | |
| ReplacementArray object caches. More... | |
| const | ALL = LanguageNameUtils::ALL |
| Return all known languages in fetchLanguageName(s). More... | |
| const | AS_AUTONYMS = LanguageNameUtils::AUTONYMS |
| Return autonyms in fetchLanguageName(s). More... | |
| const | MESSAGES_FALLBACKS = 0 |
| Return a fallback chain for messages in getFallbacksFor. More... | |
| const | STRICT_FALLBACKS = 1 |
| Return a strict fallback chain in getFallbacksFor. More... | |
| const | SUPPORTED = LanguageNameUtils::SUPPORTED |
| Return in fetchLanguageName(s) only the languages for which we have at least some localisation. More... | |
| Static Public Attributes inherited from Language | |
| 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 inherited from Language | |
| handleExplicitPluralForms ( $count, array $forms) | |
| Handles explicit plural forms for Language::convertPlural() More... | |
| mbUpperChar ( $char) | |
| Convert character to uppercase, allowing overrides of the default mb_upper behaviour, which is buggy in many ways. More... | |
| msg ( $msg) | |
| Get message object in this language. More... | |
| preConvertPlural ($forms, $count) | |
| Checks that convertPlural was given an array and pads it to requested amount of forms by copying the last one. More... | |
| removeBadCharFirst ( $string) | |
| Remove bytes that represent an incomplete Unicode character at the start of string (e.g. More... | |
| removeBadCharLast ( $string) | |
| Remove bytes that represent an incomplete Unicode character at the end of string (e.g. More... | |
| transformUsingPairFile ( $file, $string) | |
| Transform a string using serialized data stored in the given file (which must be in the serialized subdirectory of $IP). More... | |
| Static Protected Member Functions inherited from Language | |
| static | convertDoubleWidth ( $string) |
| convert double-width roman characters to single-width. More... | |
| static | insertSpace ( $string, $pattern) |
| static | newFromCode ( $code, $fallback=false) |
| Create a language object for a given language code. More... | |
| Protected Attributes inherited from Language | |
| $mNamespaceIds | |
| array null | $namespaceNames |
Detailed Description
class that handles both Traditional and Simplified Chinese right now it only distinguish zh_hans, zh_hant, zh_cn, zh_tw, zh_sg and zh_hk.
Definition at line 114 of file LanguageZh.php.
Constructor & Destructor Documentation
◆ __construct()
| LanguageZh::__construct | ( | ) |
Reimplemented from Language.
Reimplemented in LanguageGan.
Definition at line 115 of file LanguageZh.php.
Member Function Documentation
◆ convertForSearchResult()
| LanguageZh::convertForSearchResult | ( | $termsArray | ) |
- Parameters
-
string[] $termsArray
- Returns
- string[]
Reimplemented from Language.
Definition at line 194 of file LanguageZh.php.
References Language\convertDoubleWidth().
◆ normalizeForSearch()
| LanguageZh::normalizeForSearch | ( | $string, | |
$autoVariant = 'zh-hans' |
|||
| ) |
auto convert to zh-hans and normalize special characters.
- Parameters
-
string $string string $autoVariant Defaults to 'zh-hans'
- Returns
- string
Reimplemented in LanguageGan.
Definition at line 179 of file LanguageZh.php.
References $s.
◆ segmentForDiff()
| LanguageZh::segmentForDiff | ( | $text | ) |
this should give much better diff info
- Parameters
-
string $text
- Returns
- string
Reimplemented from Language.
Definition at line 160 of file LanguageZh.php.
◆ unsegmentForDiff()
| LanguageZh::unsegmentForDiff | ( | $text | ) |
- Parameters
-
string $text
- Returns
- string
Reimplemented from Language.
Definition at line 168 of file LanguageZh.php.
The documentation for this class was generated from the following file:
- languages/classes/LanguageZh.php
