SpecialChangeEmail: error if old email was entered in new email field
[lhc/web/wiklou.git] / languages / Language.php
1 <?php
2 /**
3 * Internationalisation code.
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
19 *
20 * @file
21 * @ingroup Language
22 */
23
24 /**
25 * @defgroup Language Language
26 */
27
28 if ( !defined( 'MEDIAWIKI' ) ) {
29 echo "This file is part of MediaWiki, it is not a valid entry point.\n";
30 exit( 1 );
31 }
32
33 if ( function_exists( 'mb_strtoupper' ) ) {
34 mb_internal_encoding( 'UTF-8' );
35 }
36
37 /**
38 * Internationalisation code
39 * @ingroup Language
40 */
41 class Language {
42 /**
43 * @var LanguageConverter
44 */
45 public $mConverter;
46
47 public $mVariants, $mCode, $mLoaded = false;
48 public $mMagicExtensions = array(), $mMagicHookDone = false;
49 private $mHtmlCode = null, $mParentLanguage = false;
50
51 public $dateFormatStrings = array();
52 public $mExtendedSpecialPageAliases;
53
54 protected $namespaceNames, $mNamespaceIds, $namespaceAliases;
55
56 /**
57 * ReplacementArray object caches
58 */
59 public $transformData = array();
60
61 /**
62 * @var LocalisationCache
63 */
64 static public $dataCache;
65
66 static public $mLangObjCache = array();
67
68 static public $mWeekdayMsgs = array(
69 'sunday', 'monday', 'tuesday', 'wednesday', 'thursday',
70 'friday', 'saturday'
71 );
72
73 static public $mWeekdayAbbrevMsgs = array(
74 'sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'
75 );
76
77 static public $mMonthMsgs = array(
78 'january', 'february', 'march', 'april', 'may_long', 'june',
79 'july', 'august', 'september', 'october', 'november',
80 'december'
81 );
82 static public $mMonthGenMsgs = array(
83 'january-gen', 'february-gen', 'march-gen', 'april-gen', 'may-gen', 'june-gen',
84 'july-gen', 'august-gen', 'september-gen', 'october-gen', 'november-gen',
85 'december-gen'
86 );
87 static public $mMonthAbbrevMsgs = array(
88 'jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug',
89 'sep', 'oct', 'nov', 'dec'
90 );
91
92 static public $mIranianCalendarMonthMsgs = array(
93 'iranian-calendar-m1', 'iranian-calendar-m2', 'iranian-calendar-m3',
94 'iranian-calendar-m4', 'iranian-calendar-m5', 'iranian-calendar-m6',
95 'iranian-calendar-m7', 'iranian-calendar-m8', 'iranian-calendar-m9',
96 'iranian-calendar-m10', 'iranian-calendar-m11', 'iranian-calendar-m12'
97 );
98
99 static public $mHebrewCalendarMonthMsgs = array(
100 'hebrew-calendar-m1', 'hebrew-calendar-m2', 'hebrew-calendar-m3',
101 'hebrew-calendar-m4', 'hebrew-calendar-m5', 'hebrew-calendar-m6',
102 'hebrew-calendar-m7', 'hebrew-calendar-m8', 'hebrew-calendar-m9',
103 'hebrew-calendar-m10', 'hebrew-calendar-m11', 'hebrew-calendar-m12',
104 'hebrew-calendar-m6a', 'hebrew-calendar-m6b'
105 );
106
107 static public $mHebrewCalendarMonthGenMsgs = array(
108 'hebrew-calendar-m1-gen', 'hebrew-calendar-m2-gen', 'hebrew-calendar-m3-gen',
109 'hebrew-calendar-m4-gen', 'hebrew-calendar-m5-gen', 'hebrew-calendar-m6-gen',
110 'hebrew-calendar-m7-gen', 'hebrew-calendar-m8-gen', 'hebrew-calendar-m9-gen',
111 'hebrew-calendar-m10-gen', 'hebrew-calendar-m11-gen', 'hebrew-calendar-m12-gen',
112 'hebrew-calendar-m6a-gen', 'hebrew-calendar-m6b-gen'
113 );
114
115 static public $mHijriCalendarMonthMsgs = array(
116 'hijri-calendar-m1', 'hijri-calendar-m2', 'hijri-calendar-m3',
117 'hijri-calendar-m4', 'hijri-calendar-m5', 'hijri-calendar-m6',
118 'hijri-calendar-m7', 'hijri-calendar-m8', 'hijri-calendar-m9',
119 'hijri-calendar-m10', 'hijri-calendar-m11', 'hijri-calendar-m12'
120 );
121
122 /**
123 * @since 1.20
124 * @var array
125 */
126 static public $durationIntervals = array(
127 'millennia' => 31556952000,
128 'centuries' => 3155695200,
129 'decades' => 315569520,
130 'years' => 31556952, // 86400 * ( 365 + ( 24 * 3 + 25 ) / 400 )
131 'weeks' => 604800,
132 'days' => 86400,
133 'hours' => 3600,
134 'minutes' => 60,
135 'seconds' => 1,
136 );
137
138 /**
139 * Cache for language fallbacks.
140 * @see Language::getFallbacksIncludingSiteLanguage
141 * @since 1.21
142 * @var array
143 */
144 static private $fallbackLanguageCache = array();
145
146 /**
147 * Cache for language names
148 * @var MapCacheLRU|null
149 */
150 static private $languageNameCache;
151
152 /**
153 * Unicode directional formatting characters, for embedBidi()
154 */
155 static private $lre = "\xE2\x80\xAA"; // U+202A LEFT-TO-RIGHT EMBEDDING
156 static private $rle = "\xE2\x80\xAB"; // U+202B RIGHT-TO-LEFT EMBEDDING
157 static private $pdf = "\xE2\x80\xAC"; // U+202C POP DIRECTIONAL FORMATTING
158
159 /**
160 * Directionality test regex for embedBidi(). Matches the first strong directionality codepoint:
161 * - in group 1 if it is LTR
162 * - in group 2 if it is RTL
163 * Does not match if there is no strong directionality codepoint.
164 *
165 * The form is '/(?:([strong ltr codepoint])|([strong rtl codepoint]))/u' .
166 *
167 * Generated by UnicodeJS (see tools/strongDir) from the UCD; see
168 * https://git.wikimedia.org/summary/unicodejs.git .
169 */
170 // @codingStandardsIgnoreStart
171 // @codeCoverageIgnoreStart
172 static private $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';
173 // @codeCoverageIgnoreEnd
174 // @codingStandardsIgnoreEnd
175
176 /**
177 * Get a cached or new language object for a given language code
178 * @param string $code
179 * @return Language
180 */
181 static function factory( $code ) {
182 global $wgDummyLanguageCodes, $wgLangObjCacheSize;
183
184 if ( isset( $wgDummyLanguageCodes[$code] ) ) {
185 $code = $wgDummyLanguageCodes[$code];
186 }
187
188 // get the language object to process
189 $langObj = isset( self::$mLangObjCache[$code] )
190 ? self::$mLangObjCache[$code]
191 : self::newFromCode( $code );
192
193 // merge the language object in to get it up front in the cache
194 self::$mLangObjCache = array_merge( array( $code => $langObj ), self::$mLangObjCache );
195 // get rid of the oldest ones in case we have an overflow
196 self::$mLangObjCache = array_slice( self::$mLangObjCache, 0, $wgLangObjCacheSize, true );
197
198 return $langObj;
199 }
200
201 /**
202 * Create a language object for a given language code
203 * @param string $code
204 * @throws MWException
205 * @return Language
206 */
207 protected static function newFromCode( $code ) {
208 // Protect against path traversal below
209 if ( !Language::isValidCode( $code )
210 || strcspn( $code, ":/\\\000" ) !== strlen( $code )
211 ) {
212 throw new MWException( "Invalid language code \"$code\"" );
213 }
214
215 if ( !Language::isValidBuiltInCode( $code ) ) {
216 // It's not possible to customise this code with class files, so
217 // just return a Language object. This is to support uselang= hacks.
218 $lang = new Language;
219 $lang->setCode( $code );
220 return $lang;
221 }
222
223 // Check if there is a language class for the code
224 $class = self::classFromCode( $code );
225 self::preloadLanguageClass( $class );
226 if ( class_exists( $class ) ) {
227 $lang = new $class;
228 return $lang;
229 }
230
231 // Keep trying the fallback list until we find an existing class
232 $fallbacks = Language::getFallbacksFor( $code );
233 foreach ( $fallbacks as $fallbackCode ) {
234 if ( !Language::isValidBuiltInCode( $fallbackCode ) ) {
235 throw new MWException( "Invalid fallback '$fallbackCode' in fallback sequence for '$code'" );
236 }
237
238 $class = self::classFromCode( $fallbackCode );
239 self::preloadLanguageClass( $class );
240 if ( class_exists( $class ) ) {
241 $lang = Language::newFromCode( $fallbackCode );
242 $lang->setCode( $code );
243 return $lang;
244 }
245 }
246
247 throw new MWException( "Invalid fallback sequence for language '$code'" );
248 }
249
250 /**
251 * Checks whether any localisation is available for that language tag
252 * in MediaWiki (MessagesXx.php exists).
253 *
254 * @param string $code Language tag (in lower case)
255 * @return bool Whether language is supported
256 * @since 1.21
257 */
258 public static function isSupportedLanguage( $code ) {
259 if ( !self::isValidBuiltInCode( $code ) ) {
260 return false;
261 }
262
263 if ( $code === 'qqq' ) {
264 return false;
265 }
266
267 return is_readable( self::getMessagesFileName( $code ) ) ||
268 is_readable( self::getJsonMessagesFileName( $code ) );
269 }
270
271 /**
272 * Returns true if a language code string is a well-formed language tag
273 * according to RFC 5646.
274 * This function only checks well-formedness; it doesn't check that
275 * language, script or variant codes actually exist in the repositories.
276 *
277 * Based on regexes by Mark Davis of the Unicode Consortium:
278 * http://unicode.org/repos/cldr/trunk/tools/java/org/unicode/cldr/util/data/langtagRegex.txt
279 *
280 * @param string $code
281 * @param bool $lenient Whether to allow '_' as separator. The default is only '-'.
282 *
283 * @return bool
284 * @since 1.21
285 */
286 public static function isWellFormedLanguageTag( $code, $lenient = false ) {
287 $alpha = '[a-z]';
288 $digit = '[0-9]';
289 $alphanum = '[a-z0-9]';
290 $x = 'x'; # private use singleton
291 $singleton = '[a-wy-z]'; # other singleton
292 $s = $lenient ? '[-_]' : '-';
293
294 $language = "$alpha{2,8}|$alpha{2,3}$s$alpha{3}";
295 $script = "$alpha{4}"; # ISO 15924
296 $region = "(?:$alpha{2}|$digit{3})"; # ISO 3166-1 alpha-2 or UN M.49
297 $variant = "(?:$alphanum{5,8}|$digit$alphanum{3})";
298 $extension = "$singleton(?:$s$alphanum{2,8})+";
299 $privateUse = "$x(?:$s$alphanum{1,8})+";
300
301 # Define certain grandfathered codes, since otherwise the regex is pretty useless.
302 # Since these are limited, this is safe even later changes to the registry --
303 # the only oddity is that it might change the type of the tag, and thus
304 # the results from the capturing groups.
305 # http://www.iana.org/assignments/language-subtag-registry
306
307 $grandfathered = "en{$s}GB{$s}oed"
308 . "|i{$s}(?:ami|bnn|default|enochian|hak|klingon|lux|mingo|navajo|pwn|tao|tay|tsu)"
309 . "|no{$s}(?:bok|nyn)"
310 . "|sgn{$s}(?:BE{$s}(?:fr|nl)|CH{$s}de)"
311 . "|zh{$s}min{$s}nan";
312
313 $variantList = "$variant(?:$s$variant)*";
314 $extensionList = "$extension(?:$s$extension)*";
315
316 $langtag = "(?:($language)"
317 . "(?:$s$script)?"
318 . "(?:$s$region)?"
319 . "(?:$s$variantList)?"
320 . "(?:$s$extensionList)?"
321 . "(?:$s$privateUse)?)";
322
323 # The final breakdown, with capturing groups for each of these components
324 # The variants, extensions, grandfathered, and private-use may have interior '-'
325
326 $root = "^(?:$langtag|$privateUse|$grandfathered)$";
327
328 return (bool)preg_match( "/$root/", strtolower( $code ) );
329 }
330
331 /**
332 * Returns true if a language code string is of a valid form, whether or
333 * not it exists. This includes codes which are used solely for
334 * customisation via the MediaWiki namespace.
335 *
336 * @param string $code
337 *
338 * @return bool
339 */
340 public static function isValidCode( $code ) {
341 static $cache = array();
342 if ( isset( $cache[$code] ) ) {
343 return $cache[$code];
344 }
345 // People think language codes are html safe, so enforce it.
346 // Ideally we should only allow a-zA-Z0-9-
347 // but, .+ and other chars are often used for {{int:}} hacks
348 // see bugs 37564, 37587, 36938
349 $cache[$code] =
350 strcspn( $code, ":/\\\000&<>'\"" ) === strlen( $code )
351 && !preg_match( MediaWikiTitleCodec::getTitleInvalidRegex(), $code );
352
353 return $cache[$code];
354 }
355
356 /**
357 * Returns true if a language code is of a valid form for the purposes of
358 * internal customisation of MediaWiki, via Messages*.php or *.json.
359 *
360 * @param string $code
361 *
362 * @throws MWException
363 * @since 1.18
364 * @return bool
365 */
366 public static function isValidBuiltInCode( $code ) {
367
368 if ( !is_string( $code ) ) {
369 if ( is_object( $code ) ) {
370 $addmsg = " of class " . get_class( $code );
371 } else {
372 $addmsg = '';
373 }
374 $type = gettype( $code );
375 throw new MWException( __METHOD__ . " must be passed a string, $type given$addmsg" );
376 }
377
378 return (bool)preg_match( '/^[a-z0-9-]{2,}$/', $code );
379 }
380
381 /**
382 * Returns true if a language code is an IETF tag known to MediaWiki.
383 *
384 * @param string $tag
385 *
386 * @since 1.21
387 * @return bool
388 */
389 public static function isKnownLanguageTag( $tag ) {
390 static $coreLanguageNames;
391
392 // Quick escape for invalid input to avoid exceptions down the line
393 // when code tries to process tags which are not valid at all.
394 if ( !self::isValidBuiltInCode( $tag ) ) {
395 return false;
396 }
397
398 if ( $coreLanguageNames === null ) {
399 global $IP;
400 include "$IP/languages/Names.php";
401 }
402
403 if ( isset( $coreLanguageNames[$tag] )
404 || self::fetchLanguageName( $tag, $tag ) !== ''
405 ) {
406 return true;
407 }
408
409 return false;
410 }
411
412 /**
413 * @param string $code
414 * @return string Name of the language class
415 */
416 public static function classFromCode( $code ) {
417 if ( $code == 'en' ) {
418 return 'Language';
419 } else {
420 return 'Language' . str_replace( '-', '_', ucfirst( $code ) );
421 }
422 }
423
424 /**
425 * Includes language class files
426 *
427 * @param string $class Name of the language class
428 */
429 public static function preloadLanguageClass( $class ) {
430 global $IP;
431
432 if ( $class === 'Language' ) {
433 return;
434 }
435
436 if ( file_exists( "$IP/languages/classes/$class.php" ) ) {
437 include_once "$IP/languages/classes/$class.php";
438 }
439 }
440
441 /**
442 * Get the LocalisationCache instance
443 *
444 * @return LocalisationCache
445 */
446 public static function getLocalisationCache() {
447 if ( is_null( self::$dataCache ) ) {
448 global $wgLocalisationCacheConf;
449 $class = $wgLocalisationCacheConf['class'];
450 self::$dataCache = new $class( $wgLocalisationCacheConf );
451 }
452 return self::$dataCache;
453 }
454
455 function __construct() {
456 $this->mConverter = new FakeConverter( $this );
457 // Set the code to the name of the descendant
458 if ( get_class( $this ) == 'Language' ) {
459 $this->mCode = 'en';
460 } else {
461 $this->mCode = str_replace( '_', '-', strtolower( substr( get_class( $this ), 8 ) ) );
462 }
463 self::getLocalisationCache();
464 }
465
466 /**
467 * Reduce memory usage
468 */
469 function __destruct() {
470 foreach ( $this as $name => $value ) {
471 unset( $this->$name );
472 }
473 }
474
475 /**
476 * Hook which will be called if this is the content language.
477 * Descendants can use this to register hook functions or modify globals
478 */
479 function initContLang() {
480 }
481
482 /**
483 * @return array
484 * @since 1.19
485 */
486 function getFallbackLanguages() {
487 return self::getFallbacksFor( $this->mCode );
488 }
489
490 /**
491 * Exports $wgBookstoreListEn
492 * @return array
493 */
494 function getBookstoreList() {
495 return self::$dataCache->getItem( $this->mCode, 'bookstoreList' );
496 }
497
498 /**
499 * Returns an array of localised namespaces indexed by their numbers. If the namespace is not
500 * available in localised form, it will be included in English.
501 *
502 * @return array
503 */
504 public function getNamespaces() {
505 if ( is_null( $this->namespaceNames ) ) {
506 global $wgMetaNamespace, $wgMetaNamespaceTalk, $wgExtraNamespaces;
507
508 $this->namespaceNames = self::$dataCache->getItem( $this->mCode, 'namespaceNames' );
509 $validNamespaces = MWNamespace::getCanonicalNamespaces();
510
511 $this->namespaceNames = $wgExtraNamespaces + $this->namespaceNames + $validNamespaces;
512
513 $this->namespaceNames[NS_PROJECT] = $wgMetaNamespace;
514 if ( $wgMetaNamespaceTalk ) {
515 $this->namespaceNames[NS_PROJECT_TALK] = $wgMetaNamespaceTalk;
516 } else {
517 $talk = $this->namespaceNames[NS_PROJECT_TALK];
518 $this->namespaceNames[NS_PROJECT_TALK] =
519 $this->fixVariableInNamespace( $talk );
520 }
521
522 # Sometimes a language will be localised but not actually exist on this wiki.
523 foreach ( $this->namespaceNames as $key => $text ) {
524 if ( !isset( $validNamespaces[$key] ) ) {
525 unset( $this->namespaceNames[$key] );
526 }
527 }
528
529 # The above mixing may leave namespaces out of canonical order.
530 # Re-order by namespace ID number...
531 ksort( $this->namespaceNames );
532
533 Hooks::run( 'LanguageGetNamespaces', array( &$this->namespaceNames ) );
534 }
535
536 return $this->namespaceNames;
537 }
538
539 /**
540 * Arbitrarily set all of the namespace names at once. Mainly used for testing
541 * @param array $namespaces Array of namespaces (id => name)
542 */
543 public function setNamespaces( array $namespaces ) {
544 $this->namespaceNames = $namespaces;
545 $this->mNamespaceIds = null;
546 }
547
548 /**
549 * Resets all of the namespace caches. Mainly used for testing
550 */
551 public function resetNamespaces() {
552 $this->namespaceNames = null;
553 $this->mNamespaceIds = null;
554 $this->namespaceAliases = null;
555 }
556
557 /**
558 * A convenience function that returns getNamespaces() with spaces instead of underscores
559 * in values. Useful for producing output to be displayed e.g. in `<select>` forms.
560 *
561 * @return array
562 */
563 function getFormattedNamespaces() {
564 $ns = $this->getNamespaces();
565 foreach ( $ns as $k => $v ) {
566 $ns[$k] = strtr( $v, '_', ' ' );
567 }
568 return $ns;
569 }
570
571 /**
572 * Get a namespace value by key
573 *
574 * <code>
575 * $mw_ns = $wgContLang->getNsText( NS_MEDIAWIKI );
576 * echo $mw_ns; // prints 'MediaWiki'
577 * </code>
578 *
579 * @param int $index The array key of the namespace to return
580 * @return string|bool String if the namespace value exists, otherwise false
581 */
582 function getNsText( $index ) {
583 $ns = $this->getNamespaces();
584 return isset( $ns[$index] ) ? $ns[$index] : false;
585 }
586
587 /**
588 * A convenience function that returns the same thing as
589 * getNsText() except with '_' changed to ' ', useful for
590 * producing output.
591 *
592 * <code>
593 * $mw_ns = $wgContLang->getFormattedNsText( NS_MEDIAWIKI_TALK );
594 * echo $mw_ns; // prints 'MediaWiki talk'
595 * </code>
596 *
597 * @param int $index The array key of the namespace to return
598 * @return string Namespace name without underscores (empty string if namespace does not exist)
599 */
600 function getFormattedNsText( $index ) {
601 $ns = $this->getNsText( $index );
602 return strtr( $ns, '_', ' ' );
603 }
604
605 /**
606 * Returns gender-dependent namespace alias if available.
607 * See https://www.mediawiki.org/wiki/Manual:$wgExtraGenderNamespaces
608 * @param int $index Namespace index
609 * @param string $gender Gender key (male, female... )
610 * @return string
611 * @since 1.18
612 */
613 function getGenderNsText( $index, $gender ) {
614 global $wgExtraGenderNamespaces;
615
616 $ns = $wgExtraGenderNamespaces +
617 (array)self::$dataCache->getItem( $this->mCode, 'namespaceGenderAliases' );
618
619 return isset( $ns[$index][$gender] ) ? $ns[$index][$gender] : $this->getNsText( $index );
620 }
621
622 /**
623 * Whether this language uses gender-dependent namespace aliases.
624 * See https://www.mediawiki.org/wiki/Manual:$wgExtraGenderNamespaces
625 * @return bool
626 * @since 1.18
627 */
628 function needsGenderDistinction() {
629 global $wgExtraGenderNamespaces, $wgExtraNamespaces;
630 if ( count( $wgExtraGenderNamespaces ) > 0 ) {
631 // $wgExtraGenderNamespaces overrides everything
632 return true;
633 } elseif ( isset( $wgExtraNamespaces[NS_USER] ) && isset( $wgExtraNamespaces[NS_USER_TALK] ) ) {
634 /// @todo There may be other gender namespace than NS_USER & NS_USER_TALK in the future
635 // $wgExtraNamespaces overrides any gender aliases specified in i18n files
636 return false;
637 } else {
638 // Check what is in i18n files
639 $aliases = self::$dataCache->getItem( $this->mCode, 'namespaceGenderAliases' );
640 return count( $aliases ) > 0;
641 }
642 }
643
644 /**
645 * Get a namespace key by value, case insensitive.
646 * Only matches namespace names for the current language, not the
647 * canonical ones defined in Namespace.php.
648 *
649 * @param string $text
650 * @return int|bool An integer if $text is a valid value otherwise false
651 */
652 function getLocalNsIndex( $text ) {
653 $lctext = $this->lc( $text );
654 $ids = $this->getNamespaceIds();
655 return isset( $ids[$lctext] ) ? $ids[$lctext] : false;
656 }
657
658 /**
659 * @return array
660 */
661 function getNamespaceAliases() {
662 if ( is_null( $this->namespaceAliases ) ) {
663 $aliases = self::$dataCache->getItem( $this->mCode, 'namespaceAliases' );
664 if ( !$aliases ) {
665 $aliases = array();
666 } else {
667 foreach ( $aliases as $name => $index ) {
668 if ( $index === NS_PROJECT_TALK ) {
669 unset( $aliases[$name] );
670 $name = $this->fixVariableInNamespace( $name );
671 $aliases[$name] = $index;
672 }
673 }
674 }
675
676 global $wgExtraGenderNamespaces;
677 $genders = $wgExtraGenderNamespaces +
678 (array)self::$dataCache->getItem( $this->mCode, 'namespaceGenderAliases' );
679 foreach ( $genders as $index => $forms ) {
680 foreach ( $forms as $alias ) {
681 $aliases[$alias] = $index;
682 }
683 }
684
685 # Also add converted namespace names as aliases, to avoid confusion.
686 $convertedNames = array();
687 foreach ( $this->getVariants() as $variant ) {
688 if ( $variant === $this->mCode ) {
689 continue;
690 }
691 foreach ( $this->getNamespaces() as $ns => $_ ) {
692 $convertedNames[$this->getConverter()->convertNamespace( $ns, $variant )] = $ns;
693 }
694 }
695
696 $this->namespaceAliases = $aliases + $convertedNames;
697 }
698
699 return $this->namespaceAliases;
700 }
701
702 /**
703 * @return array
704 */
705 function getNamespaceIds() {
706 if ( is_null( $this->mNamespaceIds ) ) {
707 global $wgNamespaceAliases;
708 # Put namespace names and aliases into a hashtable.
709 # If this is too slow, then we should arrange it so that it is done
710 # before caching. The catch is that at pre-cache time, the above
711 # class-specific fixup hasn't been done.
712 $this->mNamespaceIds = array();
713 foreach ( $this->getNamespaces() as $index => $name ) {
714 $this->mNamespaceIds[$this->lc( $name )] = $index;
715 }
716 foreach ( $this->getNamespaceAliases() as $name => $index ) {
717 $this->mNamespaceIds[$this->lc( $name )] = $index;
718 }
719 if ( $wgNamespaceAliases ) {
720 foreach ( $wgNamespaceAliases as $name => $index ) {
721 $this->mNamespaceIds[$this->lc( $name )] = $index;
722 }
723 }
724 }
725 return $this->mNamespaceIds;
726 }
727
728 /**
729 * Get a namespace key by value, case insensitive. Canonical namespace
730 * names override custom ones defined for the current language.
731 *
732 * @param string $text
733 * @return int|bool An integer if $text is a valid value otherwise false
734 */
735 function getNsIndex( $text ) {
736 $lctext = $this->lc( $text );
737 $ns = MWNamespace::getCanonicalIndex( $lctext );
738 if ( $ns !== null ) {
739 return $ns;
740 }
741 $ids = $this->getNamespaceIds();
742 return isset( $ids[$lctext] ) ? $ids[$lctext] : false;
743 }
744
745 /**
746 * short names for language variants used for language conversion links.
747 *
748 * @param string $code
749 * @param bool $usemsg Use the "variantname-xyz" message if it exists
750 * @return string
751 */
752 function getVariantname( $code, $usemsg = true ) {
753 $msg = "variantname-$code";
754 if ( $usemsg && wfMessage( $msg )->exists() ) {
755 return $this->getMessageFromDB( $msg );
756 }
757 $name = self::fetchLanguageName( $code );
758 if ( $name ) {
759 return $name; # if it's defined as a language name, show that
760 } else {
761 # otherwise, output the language code
762 return $code;
763 }
764 }
765
766 /**
767 * @deprecated since 1.24, doesn't handle conflicting aliases. Use
768 * SpecialPageFactory::getLocalNameFor instead.
769 * @param string $name
770 * @return string
771 */
772 function specialPage( $name ) {
773 $aliases = $this->getSpecialPageAliases();
774 if ( isset( $aliases[$name][0] ) ) {
775 $name = $aliases[$name][0];
776 }
777 return $this->getNsText( NS_SPECIAL ) . ':' . $name;
778 }
779
780 /**
781 * @return array
782 */
783 function getDatePreferences() {
784 return self::$dataCache->getItem( $this->mCode, 'datePreferences' );
785 }
786
787 /**
788 * @return array
789 */
790 function getDateFormats() {
791 return self::$dataCache->getItem( $this->mCode, 'dateFormats' );
792 }
793
794 /**
795 * @return array|string
796 */
797 function getDefaultDateFormat() {
798 $df = self::$dataCache->getItem( $this->mCode, 'defaultDateFormat' );
799 if ( $df === 'dmy or mdy' ) {
800 global $wgAmericanDates;
801 return $wgAmericanDates ? 'mdy' : 'dmy';
802 } else {
803 return $df;
804 }
805 }
806
807 /**
808 * @return array
809 */
810 function getDatePreferenceMigrationMap() {
811 return self::$dataCache->getItem( $this->mCode, 'datePreferenceMigrationMap' );
812 }
813
814 /**
815 * @param string $image
816 * @return array|null
817 */
818 function getImageFile( $image ) {
819 return self::$dataCache->getSubitem( $this->mCode, 'imageFiles', $image );
820 }
821
822 /**
823 * @return array
824 * @since 1.24
825 */
826 function getImageFiles() {
827 return self::$dataCache->getItem( $this->mCode, 'imageFiles' );
828 }
829
830 /**
831 * @return array
832 */
833 function getExtraUserToggles() {
834 return (array)self::$dataCache->getItem( $this->mCode, 'extraUserToggles' );
835 }
836
837 /**
838 * @param string $tog
839 * @return string
840 */
841 function getUserToggle( $tog ) {
842 return $this->getMessageFromDB( "tog-$tog" );
843 }
844
845 /**
846 * Get native language names, indexed by code.
847 * Only those defined in MediaWiki, no other data like CLDR.
848 * If $customisedOnly is true, only returns codes with a messages file
849 *
850 * @param bool $customisedOnly
851 *
852 * @return array
853 * @deprecated since 1.20, use fetchLanguageNames()
854 */
855 public static function getLanguageNames( $customisedOnly = false ) {
856 return self::fetchLanguageNames( null, $customisedOnly ? 'mwfile' : 'mw' );
857 }
858
859 /**
860 * Get translated language names. This is done on best effort and
861 * by default this is exactly the same as Language::getLanguageNames.
862 * The CLDR extension provides translated names.
863 * @param string $code Language code.
864 * @return array Language code => language name
865 * @since 1.18.0
866 * @deprecated since 1.20, use fetchLanguageNames()
867 */
868 public static function getTranslatedLanguageNames( $code ) {
869 return self::fetchLanguageNames( $code, 'all' );
870 }
871
872 /**
873 * Get an array of language names, indexed by code.
874 * @param null|string $inLanguage Code of language in which to return the names
875 * Use null for autonyms (native names)
876 * @param string $include One of:
877 * 'all' all available languages
878 * 'mw' only if the language is defined in MediaWiki or wgExtraLanguageNames (default)
879 * 'mwfile' only if the language is in 'mw' *and* has a message file
880 * @return array Language code => language name
881 * @since 1.20
882 */
883 public static function fetchLanguageNames( $inLanguage = null, $include = 'mw' ) {
884 $cacheKey = $inLanguage === null ? 'null' : $inLanguage;
885 $cacheKey .= ":$include";
886 if ( self::$languageNameCache === null ) {
887 self::$languageNameCache = new MapCacheLRU( 20 );
888 }
889 if ( self::$languageNameCache->has( $cacheKey ) ) {
890 $ret = self::$languageNameCache->get( $cacheKey );
891 } else {
892 $ret = self::fetchLanguageNamesUncached( $inLanguage, $include );
893 self::$languageNameCache->set( $cacheKey, $ret );
894 }
895 return $ret;
896 }
897
898 /**
899 * Uncached helper for fetchLanguageNames
900 * @param null|string $inLanguage Code of language in which to return the names
901 * Use null for autonyms (native names)
902 * @param string $include One of:
903 * 'all' all available languages
904 * 'mw' only if the language is defined in MediaWiki or wgExtraLanguageNames (default)
905 * 'mwfile' only if the language is in 'mw' *and* has a message file
906 * @return array Language code => language name
907 */
908 private static function fetchLanguageNamesUncached( $inLanguage = null, $include = 'mw' ) {
909 global $wgExtraLanguageNames;
910 static $coreLanguageNames;
911
912 if ( $coreLanguageNames === null ) {
913 global $IP;
914 include "$IP/languages/Names.php";
915 }
916
917 // If passed an invalid language code to use, fallback to en
918 if ( $inLanguage !== null && !Language::isValidCode( $inLanguage ) ) {
919 $inLanguage = 'en';
920 }
921
922 $names = array();
923
924 if ( $inLanguage ) {
925 # TODO: also include when $inLanguage is null, when this code is more efficient
926 Hooks::run( 'LanguageGetTranslatedLanguageNames', array( &$names, $inLanguage ) );
927 }
928
929 $mwNames = $wgExtraLanguageNames + $coreLanguageNames;
930 foreach ( $mwNames as $mwCode => $mwName ) {
931 # - Prefer own MediaWiki native name when not using the hook
932 # - For other names just add if not added through the hook
933 if ( $mwCode === $inLanguage || !isset( $names[$mwCode] ) ) {
934 $names[$mwCode] = $mwName;
935 }
936 }
937
938 if ( $include === 'all' ) {
939 ksort( $names );
940 return $names;
941 }
942
943 $returnMw = array();
944 $coreCodes = array_keys( $mwNames );
945 foreach ( $coreCodes as $coreCode ) {
946 $returnMw[$coreCode] = $names[$coreCode];
947 }
948
949 if ( $include === 'mwfile' ) {
950 $namesMwFile = array();
951 # We do this using a foreach over the codes instead of a directory
952 # loop so that messages files in extensions will work correctly.
953 foreach ( $returnMw as $code => $value ) {
954 if ( is_readable( self::getMessagesFileName( $code ) )
955 || is_readable( self::getJsonMessagesFileName( $code ) )
956 ) {
957 $namesMwFile[$code] = $names[$code];
958 }
959 }
960
961 ksort( $namesMwFile );
962 return $namesMwFile;
963 }
964
965 ksort( $returnMw );
966 # 'mw' option; default if it's not one of the other two options (all/mwfile)
967 return $returnMw;
968 }
969
970 /**
971 * @param string $code The code of the language for which to get the name
972 * @param null|string $inLanguage Code of language in which to return the name (null for autonyms)
973 * @param string $include 'all', 'mw' or 'mwfile'; see fetchLanguageNames()
974 * @return string Language name or empty
975 * @since 1.20
976 */
977 public static function fetchLanguageName( $code, $inLanguage = null, $include = 'all' ) {
978 $code = strtolower( $code );
979 $array = self::fetchLanguageNames( $inLanguage, $include );
980 return !array_key_exists( $code, $array ) ? '' : $array[$code];
981 }
982
983 /**
984 * Get a message from the MediaWiki namespace.
985 *
986 * @param string $msg Message name
987 * @return string
988 */
989 function getMessageFromDB( $msg ) {
990 return $this->msg( $msg )->text();
991 }
992
993 /**
994 * Get message object in this language. Only for use inside this class.
995 *
996 * @param string $msg Message name
997 * @return Message
998 */
999 protected function msg( $msg ) {
1000 return wfMessage( $msg )->inLanguage( $this );
1001 }
1002
1003 /**
1004 * Get the native language name of $code.
1005 * Only if defined in MediaWiki, no other data like CLDR.
1006 * @param string $code
1007 * @return string
1008 * @deprecated since 1.20, use fetchLanguageName()
1009 */
1010 function getLanguageName( $code ) {
1011 return self::fetchLanguageName( $code );
1012 }
1013
1014 /**
1015 * @param string $key
1016 * @return string
1017 */
1018 function getMonthName( $key ) {
1019 return $this->getMessageFromDB( self::$mMonthMsgs[$key - 1] );
1020 }
1021
1022 /**
1023 * @return array
1024 */
1025 function getMonthNamesArray() {
1026 $monthNames = array( '' );
1027 for ( $i = 1; $i < 13; $i++ ) {
1028 $monthNames[] = $this->getMonthName( $i );
1029 }
1030 return $monthNames;
1031 }
1032
1033 /**
1034 * @param string $key
1035 * @return string
1036 */
1037 function getMonthNameGen( $key ) {
1038 return $this->getMessageFromDB( self::$mMonthGenMsgs[$key - 1] );
1039 }
1040
1041 /**
1042 * @param string $key
1043 * @return string
1044 */
1045 function getMonthAbbreviation( $key ) {
1046 return $this->getMessageFromDB( self::$mMonthAbbrevMsgs[$key - 1] );
1047 }
1048
1049 /**
1050 * @return array
1051 */
1052 function getMonthAbbreviationsArray() {
1053 $monthNames = array( '' );
1054 for ( $i = 1; $i < 13; $i++ ) {
1055 $monthNames[] = $this->getMonthAbbreviation( $i );
1056 }
1057 return $monthNames;
1058 }
1059
1060 /**
1061 * @param string $key
1062 * @return string
1063 */
1064 function getWeekdayName( $key ) {
1065 return $this->getMessageFromDB( self::$mWeekdayMsgs[$key - 1] );
1066 }
1067
1068 /**
1069 * @param string $key
1070 * @return string
1071 */
1072 function getWeekdayAbbreviation( $key ) {
1073 return $this->getMessageFromDB( self::$mWeekdayAbbrevMsgs[$key - 1] );
1074 }
1075
1076 /**
1077 * @param string $key
1078 * @return string
1079 */
1080 function getIranianCalendarMonthName( $key ) {
1081 return $this->getMessageFromDB( self::$mIranianCalendarMonthMsgs[$key - 1] );
1082 }
1083
1084 /**
1085 * @param string $key
1086 * @return string
1087 */
1088 function getHebrewCalendarMonthName( $key ) {
1089 return $this->getMessageFromDB( self::$mHebrewCalendarMonthMsgs[$key - 1] );
1090 }
1091
1092 /**
1093 * @param string $key
1094 * @return string
1095 */
1096 function getHebrewCalendarMonthNameGen( $key ) {
1097 return $this->getMessageFromDB( self::$mHebrewCalendarMonthGenMsgs[$key - 1] );
1098 }
1099
1100 /**
1101 * @param string $key
1102 * @return string
1103 */
1104 function getHijriCalendarMonthName( $key ) {
1105 return $this->getMessageFromDB( self::$mHijriCalendarMonthMsgs[$key - 1] );
1106 }
1107
1108 /**
1109 * Pass through result from $dateTimeObj->format()
1110 * @param DateTime|bool|null &$dateTimeObj
1111 * @param string $ts
1112 * @param DateTimeZone|bool|null $zone
1113 * @param string $code
1114 * @return string
1115 */
1116 private static function dateTimeObjFormat( &$dateTimeObj, $ts, $zone, $code ) {
1117 if ( !$dateTimeObj ) {
1118 $dateTimeObj = DateTime::createFromFormat(
1119 'YmdHis', $ts, $zone ?: new DateTimeZone( 'UTC' )
1120 );
1121 }
1122 return $dateTimeObj->format( $code );
1123 }
1124
1125 /**
1126 * This is a workalike of PHP's date() function, but with better
1127 * internationalisation, a reduced set of format characters, and a better
1128 * escaping format.
1129 *
1130 * Supported format characters are dDjlNwzWFmMntLoYyaAgGhHiscrUeIOPTZ. See
1131 * the PHP manual for definitions. There are a number of extensions, which
1132 * start with "x":
1133 *
1134 * xn Do not translate digits of the next numeric format character
1135 * xN Toggle raw digit (xn) flag, stays set until explicitly unset
1136 * xr Use roman numerals for the next numeric format character
1137 * xh Use hebrew numerals for the next numeric format character
1138 * xx Literal x
1139 * xg Genitive month name
1140 *
1141 * xij j (day number) in Iranian calendar
1142 * xiF F (month name) in Iranian calendar
1143 * xin n (month number) in Iranian calendar
1144 * xiy y (two digit year) in Iranian calendar
1145 * xiY Y (full year) in Iranian calendar
1146 *
1147 * xjj j (day number) in Hebrew calendar
1148 * xjF F (month name) in Hebrew calendar
1149 * xjt t (days in month) in Hebrew calendar
1150 * xjx xg (genitive month name) in Hebrew calendar
1151 * xjn n (month number) in Hebrew calendar
1152 * xjY Y (full year) in Hebrew calendar
1153 *
1154 * xmj j (day number) in Hijri calendar
1155 * xmF F (month name) in Hijri calendar
1156 * xmn n (month number) in Hijri calendar
1157 * xmY Y (full year) in Hijri calendar
1158 *
1159 * xkY Y (full year) in Thai solar calendar. Months and days are
1160 * identical to the Gregorian calendar
1161 * xoY Y (full year) in Minguo calendar or Juche year.
1162 * Months and days are identical to the
1163 * Gregorian calendar
1164 * xtY Y (full year) in Japanese nengo. Months and days are
1165 * identical to the Gregorian calendar
1166 *
1167 * Characters enclosed in double quotes will be considered literal (with
1168 * the quotes themselves removed). Unmatched quotes will be considered
1169 * literal quotes. Example:
1170 *
1171 * "The month is" F => The month is January
1172 * i's" => 20'11"
1173 *
1174 * Backslash escaping is also supported.
1175 *
1176 * Input timestamp is assumed to be pre-normalized to the desired local
1177 * time zone, if any. Note that the format characters crUeIOPTZ will assume
1178 * $ts is UTC if $zone is not given.
1179 *
1180 * @param string $format
1181 * @param string $ts 14-character timestamp
1182 * YYYYMMDDHHMMSS
1183 * 01234567890123
1184 * @param DateTimeZone $zone Timezone of $ts
1185 * @param[out] int $ttl The amount of time (in seconds) the output may be cached for.
1186 * Only makes sense if $ts is the current time.
1187 * @todo handling of "o" format character for Iranian, Hebrew, Hijri & Thai?
1188 *
1189 * @throws MWException
1190 * @return string
1191 */
1192 function sprintfDate( $format, $ts, DateTimeZone $zone = null, &$ttl = null ) {
1193 $s = '';
1194 $raw = false;
1195 $roman = false;
1196 $hebrewNum = false;
1197 $dateTimeObj = false;
1198 $rawToggle = false;
1199 $iranian = false;
1200 $hebrew = false;
1201 $hijri = false;
1202 $thai = false;
1203 $minguo = false;
1204 $tenno = false;
1205
1206 $usedSecond = false;
1207 $usedMinute = false;
1208 $usedHour = false;
1209 $usedAMPM = false;
1210 $usedDay = false;
1211 $usedWeek = false;
1212 $usedMonth = false;
1213 $usedYear = false;
1214 $usedISOYear = false;
1215 $usedIsLeapYear = false;
1216
1217 $usedHebrewMonth = false;
1218 $usedIranianMonth = false;
1219 $usedHijriMonth = false;
1220 $usedHebrewYear = false;
1221 $usedIranianYear = false;
1222 $usedHijriYear = false;
1223 $usedTennoYear = false;
1224
1225 if ( strlen( $ts ) !== 14 ) {
1226 throw new MWException( __METHOD__ . ": The timestamp $ts should have 14 characters" );
1227 }
1228
1229 if ( !ctype_digit( $ts ) ) {
1230 throw new MWException( __METHOD__ . ": The timestamp $ts should be a number" );
1231 }
1232
1233 $formatLength = strlen( $format );
1234 for ( $p = 0; $p < $formatLength; $p++ ) {
1235 $num = false;
1236 $code = $format[$p];
1237 if ( $code == 'x' && $p < $formatLength - 1 ) {
1238 $code .= $format[++$p];
1239 }
1240
1241 if ( ( $code === 'xi'
1242 || $code === 'xj'
1243 || $code === 'xk'
1244 || $code === 'xm'
1245 || $code === 'xo'
1246 || $code === 'xt' )
1247 && $p < $formatLength - 1 ) {
1248 $code .= $format[++$p];
1249 }
1250
1251 switch ( $code ) {
1252 case 'xx':
1253 $s .= 'x';
1254 break;
1255 case 'xn':
1256 $raw = true;
1257 break;
1258 case 'xN':
1259 $rawToggle = !$rawToggle;
1260 break;
1261 case 'xr':
1262 $roman = true;
1263 break;
1264 case 'xh':
1265 $hebrewNum = true;
1266 break;
1267 case 'xg':
1268 $usedMonth = true;
1269 $s .= $this->getMonthNameGen( substr( $ts, 4, 2 ) );
1270 break;
1271 case 'xjx':
1272 $usedHebrewMonth = true;
1273 if ( !$hebrew ) {
1274 $hebrew = self::tsToHebrew( $ts );
1275 }
1276 $s .= $this->getHebrewCalendarMonthNameGen( $hebrew[1] );
1277 break;
1278 case 'd':
1279 $usedDay = true;
1280 $num = substr( $ts, 6, 2 );
1281 break;
1282 case 'D':
1283 $usedDay = true;
1284 $s .= $this->getWeekdayAbbreviation(
1285 Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, 'w' ) + 1
1286 );
1287 break;
1288 case 'j':
1289 $usedDay = true;
1290 $num = intval( substr( $ts, 6, 2 ) );
1291 break;
1292 case 'xij':
1293 $usedDay = true;
1294 if ( !$iranian ) {
1295 $iranian = self::tsToIranian( $ts );
1296 }
1297 $num = $iranian[2];
1298 break;
1299 case 'xmj':
1300 $usedDay = true;
1301 if ( !$hijri ) {
1302 $hijri = self::tsToHijri( $ts );
1303 }
1304 $num = $hijri[2];
1305 break;
1306 case 'xjj':
1307 $usedDay = true;
1308 if ( !$hebrew ) {
1309 $hebrew = self::tsToHebrew( $ts );
1310 }
1311 $num = $hebrew[2];
1312 break;
1313 case 'l':
1314 $usedDay = true;
1315 $s .= $this->getWeekdayName(
1316 Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, 'w' ) + 1
1317 );
1318 break;
1319 case 'F':
1320 $usedMonth = true;
1321 $s .= $this->getMonthName( substr( $ts, 4, 2 ) );
1322 break;
1323 case 'xiF':
1324 $usedIranianMonth = true;
1325 if ( !$iranian ) {
1326 $iranian = self::tsToIranian( $ts );
1327 }
1328 $s .= $this->getIranianCalendarMonthName( $iranian[1] );
1329 break;
1330 case 'xmF':
1331 $usedHijriMonth = true;
1332 if ( !$hijri ) {
1333 $hijri = self::tsToHijri( $ts );
1334 }
1335 $s .= $this->getHijriCalendarMonthName( $hijri[1] );
1336 break;
1337 case 'xjF':
1338 $usedHebrewMonth = true;
1339 if ( !$hebrew ) {
1340 $hebrew = self::tsToHebrew( $ts );
1341 }
1342 $s .= $this->getHebrewCalendarMonthName( $hebrew[1] );
1343 break;
1344 case 'm':
1345 $usedMonth = true;
1346 $num = substr( $ts, 4, 2 );
1347 break;
1348 case 'M':
1349 $usedMonth = true;
1350 $s .= $this->getMonthAbbreviation( substr( $ts, 4, 2 ) );
1351 break;
1352 case 'n':
1353 $usedMonth = true;
1354 $num = intval( substr( $ts, 4, 2 ) );
1355 break;
1356 case 'xin':
1357 $usedIranianMonth = true;
1358 if ( !$iranian ) {
1359 $iranian = self::tsToIranian( $ts );
1360 }
1361 $num = $iranian[1];
1362 break;
1363 case 'xmn':
1364 $usedHijriMonth = true;
1365 if ( !$hijri ) {
1366 $hijri = self::tsToHijri( $ts );
1367 }
1368 $num = $hijri[1];
1369 break;
1370 case 'xjn':
1371 $usedHebrewMonth = true;
1372 if ( !$hebrew ) {
1373 $hebrew = self::tsToHebrew( $ts );
1374 }
1375 $num = $hebrew[1];
1376 break;
1377 case 'xjt':
1378 $usedHebrewMonth = true;
1379 if ( !$hebrew ) {
1380 $hebrew = self::tsToHebrew( $ts );
1381 }
1382 $num = $hebrew[3];
1383 break;
1384 case 'Y':
1385 $usedYear = true;
1386 $num = substr( $ts, 0, 4 );
1387 break;
1388 case 'xiY':
1389 $usedIranianYear = true;
1390 if ( !$iranian ) {
1391 $iranian = self::tsToIranian( $ts );
1392 }
1393 $num = $iranian[0];
1394 break;
1395 case 'xmY':
1396 $usedHijriYear = true;
1397 if ( !$hijri ) {
1398 $hijri = self::tsToHijri( $ts );
1399 }
1400 $num = $hijri[0];
1401 break;
1402 case 'xjY':
1403 $usedHebrewYear = true;
1404 if ( !$hebrew ) {
1405 $hebrew = self::tsToHebrew( $ts );
1406 }
1407 $num = $hebrew[0];
1408 break;
1409 case 'xkY':
1410 $usedYear = true;
1411 if ( !$thai ) {
1412 $thai = self::tsToYear( $ts, 'thai' );
1413 }
1414 $num = $thai[0];
1415 break;
1416 case 'xoY':
1417 $usedYear = true;
1418 if ( !$minguo ) {
1419 $minguo = self::tsToYear( $ts, 'minguo' );
1420 }
1421 $num = $minguo[0];
1422 break;
1423 case 'xtY':
1424 $usedTennoYear = true;
1425 if ( !$tenno ) {
1426 $tenno = self::tsToYear( $ts, 'tenno' );
1427 }
1428 $num = $tenno[0];
1429 break;
1430 case 'y':
1431 $usedYear = true;
1432 $num = substr( $ts, 2, 2 );
1433 break;
1434 case 'xiy':
1435 $usedIranianYear = true;
1436 if ( !$iranian ) {
1437 $iranian = self::tsToIranian( $ts );
1438 }
1439 $num = substr( $iranian[0], -2 );
1440 break;
1441 case 'a':
1442 $usedAMPM = true;
1443 $s .= intval( substr( $ts, 8, 2 ) ) < 12 ? 'am' : 'pm';
1444 break;
1445 case 'A':
1446 $usedAMPM = true;
1447 $s .= intval( substr( $ts, 8, 2 ) ) < 12 ? 'AM' : 'PM';
1448 break;
1449 case 'g':
1450 $usedHour = true;
1451 $h = substr( $ts, 8, 2 );
1452 $num = $h % 12 ? $h % 12 : 12;
1453 break;
1454 case 'G':
1455 $usedHour = true;
1456 $num = intval( substr( $ts, 8, 2 ) );
1457 break;
1458 case 'h':
1459 $usedHour = true;
1460 $h = substr( $ts, 8, 2 );
1461 $num = sprintf( '%02d', $h % 12 ? $h % 12 : 12 );
1462 break;
1463 case 'H':
1464 $usedHour = true;
1465 $num = substr( $ts, 8, 2 );
1466 break;
1467 case 'i':
1468 $usedMinute = true;
1469 $num = substr( $ts, 10, 2 );
1470 break;
1471 case 's':
1472 $usedSecond = true;
1473 $num = substr( $ts, 12, 2 );
1474 break;
1475 case 'c':
1476 case 'r':
1477 $usedSecond = true;
1478 // fall through
1479 case 'e':
1480 case 'O':
1481 case 'P':
1482 case 'T':
1483 $s .= Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, $code );
1484 break;
1485 case 'w':
1486 case 'N':
1487 case 'z':
1488 $usedDay = true;
1489 $num = Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, $code );
1490 break;
1491 case 'W':
1492 $usedWeek = true;
1493 $num = Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, $code );
1494 break;
1495 case 't':
1496 $usedMonth = true;
1497 $num = Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, $code );
1498 break;
1499 case 'L':
1500 $usedIsLeapYear = true;
1501 $num = Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, $code );
1502 break;
1503 case 'o':
1504 $usedISOYear = true;
1505 $num = Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, $code );
1506 break;
1507 case 'U':
1508 $usedSecond = true;
1509 // fall through
1510 case 'I':
1511 case 'Z':
1512 $num = Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, $code );
1513 break;
1514 case '\\':
1515 # Backslash escaping
1516 if ( $p < $formatLength - 1 ) {
1517 $s .= $format[++$p];
1518 } else {
1519 $s .= '\\';
1520 }
1521 break;
1522 case '"':
1523 # Quoted literal
1524 if ( $p < $formatLength - 1 ) {
1525 $endQuote = strpos( $format, '"', $p + 1 );
1526 if ( $endQuote === false ) {
1527 # No terminating quote, assume literal "
1528 $s .= '"';
1529 } else {
1530 $s .= substr( $format, $p + 1, $endQuote - $p - 1 );
1531 $p = $endQuote;
1532 }
1533 } else {
1534 # Quote at end of string, assume literal "
1535 $s .= '"';
1536 }
1537 break;
1538 default:
1539 $s .= $format[$p];
1540 }
1541 if ( $num !== false ) {
1542 if ( $rawToggle || $raw ) {
1543 $s .= $num;
1544 $raw = false;
1545 } elseif ( $roman ) {
1546 $s .= Language::romanNumeral( $num );
1547 $roman = false;
1548 } elseif ( $hebrewNum ) {
1549 $s .= self::hebrewNumeral( $num );
1550 $hebrewNum = false;
1551 } else {
1552 $s .= $this->formatNum( $num, true );
1553 }
1554 }
1555 }
1556
1557 if ( $usedSecond ) {
1558 $ttl = 1;
1559 } elseif ( $usedMinute ) {
1560 $ttl = 60 - substr( $ts, 12, 2 );
1561 } elseif ( $usedHour ) {
1562 $ttl = 3600 - substr( $ts, 10, 2 ) * 60 - substr( $ts, 12, 2 );
1563 } elseif ( $usedAMPM ) {
1564 $ttl = 43200 - ( substr( $ts, 8, 2 ) % 12 ) * 3600 -
1565 substr( $ts, 10, 2 ) * 60 - substr( $ts, 12, 2 );
1566 } elseif (
1567 $usedDay ||
1568 $usedHebrewMonth ||
1569 $usedIranianMonth ||
1570 $usedHijriMonth ||
1571 $usedHebrewYear ||
1572 $usedIranianYear ||
1573 $usedHijriYear ||
1574 $usedTennoYear
1575 ) {
1576 // @todo Someone who understands the non-Gregorian calendars
1577 // should write proper logic for them so that they don't need purged every day.
1578 $ttl = 86400 - substr( $ts, 8, 2 ) * 3600 -
1579 substr( $ts, 10, 2 ) * 60 - substr( $ts, 12, 2 );
1580 } else {
1581 $possibleTtls = array();
1582 $timeRemainingInDay = 86400 - substr( $ts, 8, 2 ) * 3600 -
1583 substr( $ts, 10, 2 ) * 60 - substr( $ts, 12, 2 );
1584 if ( $usedWeek ) {
1585 $possibleTtls[] =
1586 ( 7 - Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, 'N' ) ) * 86400 +
1587 $timeRemainingInDay;
1588 } elseif ( $usedISOYear ) {
1589 // December 28th falls on the last ISO week of the year, every year.
1590 // The last ISO week of a year can be 52 or 53.
1591 $lastWeekOfISOYear = DateTime::createFromFormat(
1592 'Ymd',
1593 substr( $ts, 0, 4 ) . '1228',
1594 $zone ?: new DateTimeZone( 'UTC' )
1595 )->format( 'W' );
1596 $currentISOWeek = Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, 'W' );
1597 $weeksRemaining = $lastWeekOfISOYear - $currentISOWeek;
1598 $timeRemainingInWeek =
1599 ( 7 - Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, 'N' ) ) * 86400
1600 + $timeRemainingInDay;
1601 $possibleTtls[] = $weeksRemaining * 604800 + $timeRemainingInWeek;
1602 }
1603
1604 if ( $usedMonth ) {
1605 $possibleTtls[] =
1606 ( Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, 't' ) -
1607 substr( $ts, 6, 2 ) ) * 86400
1608 + $timeRemainingInDay;
1609 } elseif ( $usedYear ) {
1610 $possibleTtls[] =
1611 ( Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, 'L' ) + 364 -
1612 Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, 'z' ) ) * 86400
1613 + $timeRemainingInDay;
1614 } elseif ( $usedIsLeapYear ) {
1615 $year = substr( $ts, 0, 4 );
1616 $timeRemainingInYear =
1617 ( Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, 'L' ) + 364 -
1618 Language::dateTimeObjFormat( $dateTimeObj, $ts, $zone, 'z' ) ) * 86400
1619 + $timeRemainingInDay;
1620 $mod = $year % 4;
1621 if ( $mod || ( !( $year % 100 ) && $year % 400 ) ) {
1622 // this isn't a leap year. see when the next one starts
1623 $nextCandidate = $year - $mod + 4;
1624 if ( $nextCandidate % 100 || !( $nextCandidate % 400 ) ) {
1625 $possibleTtls[] = ( $nextCandidate - $year - 1 ) * 365 * 86400 +
1626 $timeRemainingInYear;
1627 } else {
1628 $possibleTtls[] = ( $nextCandidate - $year + 3 ) * 365 * 86400 +
1629 $timeRemainingInYear;
1630 }
1631 } else {
1632 // this is a leap year, so the next year isn't
1633 $possibleTtls[] = $timeRemainingInYear;
1634 }
1635 }
1636
1637 if ( $possibleTtls ) {
1638 $ttl = min( $possibleTtls );
1639 }
1640 }
1641
1642 return $s;
1643 }
1644
1645 private static $GREG_DAYS = array( 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 );
1646 private static $IRANIAN_DAYS = array( 31, 31, 31, 31, 31, 31, 30, 30, 30, 30, 30, 29 );
1647
1648 /**
1649 * Algorithm by Roozbeh Pournader and Mohammad Toossi to convert
1650 * Gregorian dates to Iranian dates. Originally written in C, it
1651 * is released under the terms of GNU Lesser General Public
1652 * License. Conversion to PHP was performed by Niklas Laxström.
1653 *
1654 * Link: http://www.farsiweb.info/jalali/jalali.c
1655 *
1656 * @param string $ts
1657 *
1658 * @return string
1659 */
1660 private static function tsToIranian( $ts ) {
1661 $gy = substr( $ts, 0, 4 ) -1600;
1662 $gm = substr( $ts, 4, 2 ) -1;
1663 $gd = substr( $ts, 6, 2 ) -1;
1664
1665 # Days passed from the beginning (including leap years)
1666 $gDayNo = 365 * $gy
1667 + floor( ( $gy + 3 ) / 4 )
1668 - floor( ( $gy + 99 ) / 100 )
1669 + floor( ( $gy + 399 ) / 400 );
1670
1671 // Add days of the past months of this year
1672 for ( $i = 0; $i < $gm; $i++ ) {
1673 $gDayNo += self::$GREG_DAYS[$i];
1674 }
1675
1676 // Leap years
1677 if ( $gm > 1 && ( ( $gy % 4 === 0 && $gy % 100 !== 0 || ( $gy % 400 == 0 ) ) ) ) {
1678 $gDayNo++;
1679 }
1680
1681 // Days passed in current month
1682 $gDayNo += (int)$gd;
1683
1684 $jDayNo = $gDayNo - 79;
1685
1686 $jNp = floor( $jDayNo / 12053 );
1687 $jDayNo %= 12053;
1688
1689 $jy = 979 + 33 * $jNp + 4 * floor( $jDayNo / 1461 );
1690 $jDayNo %= 1461;
1691
1692 if ( $jDayNo >= 366 ) {
1693 $jy += floor( ( $jDayNo - 1 ) / 365 );
1694 $jDayNo = floor( ( $jDayNo - 1 ) % 365 );
1695 }
1696
1697 for ( $i = 0; $i < 11 && $jDayNo >= self::$IRANIAN_DAYS[$i]; $i++ ) {
1698 $jDayNo -= self::$IRANIAN_DAYS[$i];
1699 }
1700
1701 $jm = $i + 1;
1702 $jd = $jDayNo + 1;
1703
1704 return array( $jy, $jm, $jd );
1705 }
1706
1707 /**
1708 * Converting Gregorian dates to Hijri dates.
1709 *
1710 * Based on a PHP-Nuke block by Sharjeel which is released under GNU/GPL license
1711 *
1712 * @see http://phpnuke.org/modules.php?name=News&file=article&sid=8234&mode=thread&order=0&thold=0
1713 *
1714 * @param string $ts
1715 *
1716 * @return string
1717 */
1718 private static function tsToHijri( $ts ) {
1719 $year = substr( $ts, 0, 4 );
1720 $month = substr( $ts, 4, 2 );
1721 $day = substr( $ts, 6, 2 );
1722
1723 $zyr = $year;
1724 $zd = $day;
1725 $zm = $month;
1726 $zy = $zyr;
1727
1728 if (
1729 ( $zy > 1582 ) || ( ( $zy == 1582 ) && ( $zm > 10 ) ) ||
1730 ( ( $zy == 1582 ) && ( $zm == 10 ) && ( $zd > 14 ) )
1731 ) {
1732 $zjd = (int)( ( 1461 * ( $zy + 4800 + (int)( ( $zm - 14 ) / 12 ) ) ) / 4 ) +
1733 (int)( ( 367 * ( $zm - 2 - 12 * ( (int)( ( $zm - 14 ) / 12 ) ) ) ) / 12 ) -
1734 (int)( ( 3 * (int)( ( ( $zy + 4900 + (int)( ( $zm - 14 ) / 12 ) ) / 100 ) ) ) / 4 ) +
1735 $zd - 32075;
1736 } else {
1737 $zjd = 367 * $zy - (int)( ( 7 * ( $zy + 5001 + (int)( ( $zm - 9 ) / 7 ) ) ) / 4 ) +
1738 (int)( ( 275 * $zm ) / 9 ) + $zd + 1729777;
1739 }
1740
1741 $zl = $zjd -1948440 + 10632;
1742 $zn = (int)( ( $zl - 1 ) / 10631 );
1743 $zl = $zl - 10631 * $zn + 354;
1744 $zj = ( (int)( ( 10985 - $zl ) / 5316 ) ) * ( (int)( ( 50 * $zl ) / 17719 ) ) +
1745 ( (int)( $zl / 5670 ) ) * ( (int)( ( 43 * $zl ) / 15238 ) );
1746 $zl = $zl - ( (int)( ( 30 - $zj ) / 15 ) ) * ( (int)( ( 17719 * $zj ) / 50 ) ) -
1747 ( (int)( $zj / 16 ) ) * ( (int)( ( 15238 * $zj ) / 43 ) ) + 29;
1748 $zm = (int)( ( 24 * $zl ) / 709 );
1749 $zd = $zl - (int)( ( 709 * $zm ) / 24 );
1750 $zy = 30 * $zn + $zj - 30;
1751
1752 return array( $zy, $zm, $zd );
1753 }
1754
1755 /**
1756 * Converting Gregorian dates to Hebrew dates.
1757 *
1758 * Based on a JavaScript code by Abu Mami and Yisrael Hersch
1759 * (abu-mami@kaluach.net, http://www.kaluach.net), who permitted
1760 * to translate the relevant functions into PHP and release them under
1761 * GNU GPL.
1762 *
1763 * The months are counted from Tishrei = 1. In a leap year, Adar I is 13
1764 * and Adar II is 14. In a non-leap year, Adar is 6.
1765 *
1766 * @param string $ts
1767 *
1768 * @return string
1769 */
1770 private static function tsToHebrew( $ts ) {
1771 # Parse date
1772 $year = substr( $ts, 0, 4 );
1773 $month = substr( $ts, 4, 2 );
1774 $day = substr( $ts, 6, 2 );
1775
1776 # Calculate Hebrew year
1777 $hebrewYear = $year + 3760;
1778
1779 # Month number when September = 1, August = 12
1780 $month += 4;
1781 if ( $month > 12 ) {
1782 # Next year
1783 $month -= 12;
1784 $year++;
1785 $hebrewYear++;
1786 }
1787
1788 # Calculate day of year from 1 September
1789 $dayOfYear = $day;
1790 for ( $i = 1; $i < $month; $i++ ) {
1791 if ( $i == 6 ) {
1792 # February
1793 $dayOfYear += 28;
1794 # Check if the year is leap
1795 if ( $year % 400 == 0 || ( $year % 4 == 0 && $year % 100 > 0 ) ) {
1796 $dayOfYear++;
1797 }
1798 } elseif ( $i == 8 || $i == 10 || $i == 1 || $i == 3 ) {
1799 $dayOfYear += 30;
1800 } else {
1801 $dayOfYear += 31;
1802 }
1803 }
1804
1805 # Calculate the start of the Hebrew year
1806 $start = self::hebrewYearStart( $hebrewYear );
1807
1808 # Calculate next year's start
1809 if ( $dayOfYear <= $start ) {
1810 # Day is before the start of the year - it is the previous year
1811 # Next year's start
1812 $nextStart = $start;
1813 # Previous year
1814 $year--;
1815 $hebrewYear--;
1816 # Add days since previous year's 1 September
1817 $dayOfYear += 365;
1818 if ( ( $year % 400 == 0 ) || ( $year % 100 != 0 && $year % 4 == 0 ) ) {
1819 # Leap year
1820 $dayOfYear++;
1821 }
1822 # Start of the new (previous) year
1823 $start = self::hebrewYearStart( $hebrewYear );
1824 } else {
1825 # Next year's start
1826 $nextStart = self::hebrewYearStart( $hebrewYear + 1 );
1827 }
1828
1829 # Calculate Hebrew day of year
1830 $hebrewDayOfYear = $dayOfYear - $start;
1831
1832 # Difference between year's days
1833 $diff = $nextStart - $start;
1834 # Add 12 (or 13 for leap years) days to ignore the difference between
1835 # Hebrew and Gregorian year (353 at least vs. 365/6) - now the
1836 # difference is only about the year type
1837 if ( ( $year % 400 == 0 ) || ( $year % 100 != 0 && $year % 4 == 0 ) ) {
1838 $diff += 13;
1839 } else {
1840 $diff += 12;
1841 }
1842
1843 # Check the year pattern, and is leap year
1844 # 0 means an incomplete year, 1 means a regular year, 2 means a complete year
1845 # This is mod 30, to work on both leap years (which add 30 days of Adar I)
1846 # and non-leap years
1847 $yearPattern = $diff % 30;
1848 # Check if leap year
1849 $isLeap = $diff >= 30;
1850
1851 # Calculate day in the month from number of day in the Hebrew year
1852 # Don't check Adar - if the day is not in Adar, we will stop before;
1853 # if it is in Adar, we will use it to check if it is Adar I or Adar II
1854 $hebrewDay = $hebrewDayOfYear;
1855 $hebrewMonth = 1;
1856 $days = 0;
1857 while ( $hebrewMonth <= 12 ) {
1858 # Calculate days in this month
1859 if ( $isLeap && $hebrewMonth == 6 ) {
1860 # Adar in a leap year
1861 if ( $isLeap ) {
1862 # Leap year - has Adar I, with 30 days, and Adar II, with 29 days
1863 $days = 30;
1864 if ( $hebrewDay <= $days ) {
1865 # Day in Adar I
1866 $hebrewMonth = 13;
1867 } else {
1868 # Subtract the days of Adar I
1869 $hebrewDay -= $days;
1870 # Try Adar II
1871 $days = 29;
1872 if ( $hebrewDay <= $days ) {
1873 # Day in Adar II
1874 $hebrewMonth = 14;
1875 }
1876 }
1877 }
1878 } elseif ( $hebrewMonth == 2 && $yearPattern == 2 ) {
1879 # Cheshvan in a complete year (otherwise as the rule below)
1880 $days = 30;
1881 } elseif ( $hebrewMonth == 3 && $yearPattern == 0 ) {
1882 # Kislev in an incomplete year (otherwise as the rule below)
1883 $days = 29;
1884 } else {
1885 # Odd months have 30 days, even have 29
1886 $days = 30 - ( $hebrewMonth - 1 ) % 2;
1887 }
1888 if ( $hebrewDay <= $days ) {
1889 # In the current month
1890 break;
1891 } else {
1892 # Subtract the days of the current month
1893 $hebrewDay -= $days;
1894 # Try in the next month
1895 $hebrewMonth++;
1896 }
1897 }
1898
1899 return array( $hebrewYear, $hebrewMonth, $hebrewDay, $days );
1900 }
1901
1902 /**
1903 * This calculates the Hebrew year start, as days since 1 September.
1904 * Based on Carl Friedrich Gauss algorithm for finding Easter date.
1905 * Used for Hebrew date.
1906 *
1907 * @param int $year
1908 *
1909 * @return string
1910 */
1911 private static function hebrewYearStart( $year ) {
1912 $a = intval( ( 12 * ( $year - 1 ) + 17 ) % 19 );
1913 $b = intval( ( $year - 1 ) % 4 );
1914 $m = 32.044093161144 + 1.5542417966212 * $a + $b / 4.0 - 0.0031777940220923 * ( $year - 1 );
1915 if ( $m < 0 ) {
1916 $m--;
1917 }
1918 $Mar = intval( $m );
1919 if ( $m < 0 ) {
1920 $m++;
1921 }
1922 $m -= $Mar;
1923
1924 $c = intval( ( $Mar + 3 * ( $year - 1 ) + 5 * $b + 5 ) % 7 );
1925 if ( $c == 0 && $a > 11 && $m >= 0.89772376543210 ) {
1926 $Mar++;
1927 } elseif ( $c == 1 && $a > 6 && $m >= 0.63287037037037 ) {
1928 $Mar += 2;
1929 } elseif ( $c == 2 || $c == 4 || $c == 6 ) {
1930 $Mar++;
1931 }
1932
1933 $Mar += intval( ( $year - 3761 ) / 100 ) - intval( ( $year - 3761 ) / 400 ) - 24;
1934 return $Mar;
1935 }
1936
1937 /**
1938 * Algorithm to convert Gregorian dates to Thai solar dates,
1939 * Minguo dates or Minguo dates.
1940 *
1941 * Link: http://en.wikipedia.org/wiki/Thai_solar_calendar
1942 * http://en.wikipedia.org/wiki/Minguo_calendar
1943 * http://en.wikipedia.org/wiki/Japanese_era_name
1944 *
1945 * @param string $ts 14-character timestamp
1946 * @param string $cName Calender name
1947 * @return array Converted year, month, day
1948 */
1949 private static function tsToYear( $ts, $cName ) {
1950 $gy = substr( $ts, 0, 4 );
1951 $gm = substr( $ts, 4, 2 );
1952 $gd = substr( $ts, 6, 2 );
1953
1954 if ( !strcmp( $cName, 'thai' ) ) {
1955 # Thai solar dates
1956 # Add 543 years to the Gregorian calendar
1957 # Months and days are identical
1958 $gy_offset = $gy + 543;
1959 } elseif ( ( !strcmp( $cName, 'minguo' ) ) || !strcmp( $cName, 'juche' ) ) {
1960 # Minguo dates
1961 # Deduct 1911 years from the Gregorian calendar
1962 # Months and days are identical
1963 $gy_offset = $gy - 1911;
1964 } elseif ( !strcmp( $cName, 'tenno' ) ) {
1965 # Nengō dates up to Meiji period
1966 # Deduct years from the Gregorian calendar
1967 # depending on the nengo periods
1968 # Months and days are identical
1969 if ( ( $gy < 1912 )
1970 || ( ( $gy == 1912 ) && ( $gm < 7 ) )
1971 || ( ( $gy == 1912 ) && ( $gm == 7 ) && ( $gd < 31 ) )
1972 ) {
1973 # Meiji period
1974 $gy_gannen = $gy - 1868 + 1;
1975 $gy_offset = $gy_gannen;
1976 if ( $gy_gannen == 1 ) {
1977 $gy_offset = '元';
1978 }
1979 $gy_offset = '明治' . $gy_offset;
1980 } elseif (
1981 ( ( $gy == 1912 ) && ( $gm == 7 ) && ( $gd == 31 ) ) ||
1982 ( ( $gy == 1912 ) && ( $gm >= 8 ) ) ||
1983 ( ( $gy > 1912 ) && ( $gy < 1926 ) ) ||
1984 ( ( $gy == 1926 ) && ( $gm < 12 ) ) ||
1985 ( ( $gy == 1926 ) && ( $gm == 12 ) && ( $gd < 26 ) )
1986 ) {
1987 # Taishō period
1988 $gy_gannen = $gy - 1912 + 1;
1989 $gy_offset = $gy_gannen;
1990 if ( $gy_gannen == 1 ) {
1991 $gy_offset = '元';
1992 }
1993 $gy_offset = '大正' . $gy_offset;
1994 } elseif (
1995 ( ( $gy == 1926 ) && ( $gm == 12 ) && ( $gd >= 26 ) ) ||
1996 ( ( $gy > 1926 ) && ( $gy < 1989 ) ) ||
1997 ( ( $gy == 1989 ) && ( $gm == 1 ) && ( $gd < 8 ) )
1998 ) {
1999 # Shōwa period
2000 $gy_gannen = $gy - 1926 + 1;
2001 $gy_offset = $gy_gannen;
2002 if ( $gy_gannen == 1 ) {
2003 $gy_offset = '元';
2004 }
2005 $gy_offset = '昭和' . $gy_offset;
2006 } else {
2007 # Heisei period
2008 $gy_gannen = $gy - 1989 + 1;
2009 $gy_offset = $gy_gannen;
2010 if ( $gy_gannen == 1 ) {
2011 $gy_offset = '元';
2012 }
2013 $gy_offset = '平成' . $gy_offset;
2014 }
2015 } else {
2016 $gy_offset = $gy;
2017 }
2018
2019 return array( $gy_offset, $gm, $gd );
2020 }
2021
2022 /**
2023 * Gets directionality of the first strongly directional codepoint, for embedBidi()
2024 *
2025 * This is the rule the BIDI algorithm uses to determine the directionality of
2026 * paragraphs ( http://unicode.org/reports/tr9/#The_Paragraph_Level ) and
2027 * FSI isolates ( http://unicode.org/reports/tr9/#Explicit_Directional_Isolates ).
2028 *
2029 * TODO: Does not handle BIDI control characters inside the text.
2030 * TODO: Does not handle unallocated characters.
2031 *
2032 * @param string $text Text to test
2033 * @return null|string Directionality ('ltr' or 'rtl') or null
2034 */
2035 private static function strongDirFromContent( $text = '' ) {
2036 if ( !preg_match( self::$strongDirRegex, $text, $matches ) ) {
2037 return null;
2038 }
2039 if ( $matches[1] === '' ) {
2040 return 'rtl';
2041 }
2042 return 'ltr';
2043 }
2044
2045 /**
2046 * Roman number formatting up to 10000
2047 *
2048 * @param int $num
2049 *
2050 * @return string
2051 */
2052 static function romanNumeral( $num ) {
2053 static $table = array(
2054 array( '', 'I', 'II', 'III', 'IV', 'V', 'VI', 'VII', 'VIII', 'IX', 'X' ),
2055 array( '', 'X', 'XX', 'XXX', 'XL', 'L', 'LX', 'LXX', 'LXXX', 'XC', 'C' ),
2056 array( '', 'C', 'CC', 'CCC', 'CD', 'D', 'DC', 'DCC', 'DCCC', 'CM', 'M' ),
2057 array( '', 'M', 'MM', 'MMM', 'MMMM', 'MMMMM', 'MMMMMM', 'MMMMMMM',
2058 'MMMMMMMM', 'MMMMMMMMM', 'MMMMMMMMMM' )
2059 );
2060
2061 $num = intval( $num );
2062 if ( $num > 10000 || $num <= 0 ) {
2063 return $num;
2064 }
2065
2066 $s = '';
2067 for ( $pow10 = 1000, $i = 3; $i >= 0; $pow10 /= 10, $i-- ) {
2068 if ( $num >= $pow10 ) {
2069 $s .= $table[$i][(int)floor( $num / $pow10 )];
2070 }
2071 $num = $num % $pow10;
2072 }
2073 return $s;
2074 }
2075
2076 /**
2077 * Hebrew Gematria number formatting up to 9999
2078 *
2079 * @param int $num
2080 *
2081 * @return string
2082 */
2083 static function hebrewNumeral( $num ) {
2084 static $table = array(
2085 array( '', 'א', 'ב', 'ג', 'ד', 'ה', 'ו', 'ז', 'ח', 'ט', 'י' ),
2086 array( '', 'י', 'כ', 'ל', 'מ', 'נ', 'ס', 'ע', 'פ', 'צ', 'ק' ),
2087 array( '',
2088 array( 'ק' ),
2089 array( 'ר' ),
2090 array( 'ש' ),
2091 array( 'ת' ),
2092 array( 'ת', 'ק' ),
2093 array( 'ת', 'ר' ),
2094 array( 'ת', 'ש' ),
2095 array( 'ת', 'ת' ),
2096 array( 'ת', 'ת', 'ק' ),
2097 array( 'ת', 'ת', 'ר' ),
2098 ),
2099 array( '', 'א', 'ב', 'ג', 'ד', 'ה', 'ו', 'ז', 'ח', 'ט', 'י' )
2100 );
2101
2102 $num = intval( $num );
2103 if ( $num > 9999 || $num <= 0 ) {
2104 return $num;
2105 }
2106
2107 // Round thousands have special notations
2108 if ( $num === 1000 ) {
2109 return "א' אלף";
2110 } elseif ( $num % 1000 === 0 ) {
2111 return $table[0][$num / 1000] . "' אלפים";
2112 }
2113
2114 $letters = array();
2115
2116 for ( $pow10 = 1000, $i = 3; $i >= 0; $pow10 /= 10, $i-- ) {
2117 if ( $num >= $pow10 ) {
2118 if ( $num === 15 || $num === 16 ) {
2119 $letters[] = $table[0][9];
2120 $letters[] = $table[0][$num - 9];
2121 $num = 0;
2122 } else {
2123 $letters = array_merge(
2124 $letters,
2125 (array)$table[$i][intval( $num / $pow10 )]
2126 );
2127
2128 if ( $pow10 === 1000 ) {
2129 $letters[] = "'";
2130 }
2131 }
2132 }
2133
2134 $num = $num % $pow10;
2135 }
2136
2137 $preTransformLength = count( $letters );
2138 if ( $preTransformLength === 1 ) {
2139 // Add geresh (single quote) to one-letter numbers
2140 $letters[] = "'";
2141 } else {
2142 $lastIndex = $preTransformLength - 1;
2143 $letters[$lastIndex] = str_replace(
2144 array( 'כ', 'מ', 'נ', 'פ', 'צ' ),
2145 array( 'ך', 'ם', 'ן', 'ף', 'ץ' ),
2146 $letters[$lastIndex]
2147 );
2148
2149 // Add gershayim (double quote) to multiple-letter numbers,
2150 // but exclude numbers with only one letter after the thousands
2151 // (1001-1009, 1020, 1030, 2001-2009, etc.)
2152 if ( $letters[1] === "'" && $preTransformLength === 3 ) {
2153 $letters[] = "'";
2154 } else {
2155 array_splice( $letters, -1, 0, '"' );
2156 }
2157 }
2158
2159 return implode( $letters );
2160 }
2161
2162 /**
2163 * Used by date() and time() to adjust the time output.
2164 *
2165 * @param string $ts The time in date('YmdHis') format
2166 * @param mixed $tz Adjust the time by this amount (default false, mean we
2167 * get user timecorrection setting)
2168 * @return int
2169 */
2170 function userAdjust( $ts, $tz = false ) {
2171 global $wgUser, $wgLocalTZoffset;
2172
2173 if ( $tz === false ) {
2174 $tz = $wgUser->getOption( 'timecorrection' );
2175 }
2176
2177 $data = explode( '|', $tz, 3 );
2178
2179 if ( $data[0] == 'ZoneInfo' ) {
2180 MediaWiki\suppressWarnings();
2181 $userTZ = timezone_open( $data[2] );
2182 MediaWiki\restoreWarnings();
2183 if ( $userTZ !== false ) {
2184 $date = date_create( $ts, timezone_open( 'UTC' ) );
2185 date_timezone_set( $date, $userTZ );
2186 $date = date_format( $date, 'YmdHis' );
2187 return $date;
2188 }
2189 # Unrecognized timezone, default to 'Offset' with the stored offset.
2190 $data[0] = 'Offset';
2191 }
2192
2193 if ( $data[0] == 'System' || $tz == '' ) {
2194 # Global offset in minutes.
2195 $minDiff = $wgLocalTZoffset;
2196 } elseif ( $data[0] == 'Offset' ) {
2197 $minDiff = intval( $data[1] );
2198 } else {
2199 $data = explode( ':', $tz );
2200 if ( count( $data ) == 2 ) {
2201 $data[0] = intval( $data[0] );
2202 $data[1] = intval( $data[1] );
2203 $minDiff = abs( $data[0] ) * 60 + $data[1];
2204 if ( $data[0] < 0 ) {
2205 $minDiff = -$minDiff;
2206 }
2207 } else {
2208 $minDiff = intval( $data[0] ) * 60;
2209 }
2210 }
2211
2212 # No difference ? Return time unchanged
2213 if ( 0 == $minDiff ) {
2214 return $ts;
2215 }
2216
2217 MediaWiki\suppressWarnings(); // E_STRICT system time bitching
2218 # Generate an adjusted date; take advantage of the fact that mktime
2219 # will normalize out-of-range values so we don't have to split $minDiff
2220 # into hours and minutes.
2221 $t = mktime( (
2222 (int)substr( $ts, 8, 2 ) ), # Hours
2223 (int)substr( $ts, 10, 2 ) + $minDiff, # Minutes
2224 (int)substr( $ts, 12, 2 ), # Seconds
2225 (int)substr( $ts, 4, 2 ), # Month
2226 (int)substr( $ts, 6, 2 ), # Day
2227 (int)substr( $ts, 0, 4 ) ); # Year
2228
2229 $date = date( 'YmdHis', $t );
2230 MediaWiki\restoreWarnings();
2231
2232 return $date;
2233 }
2234
2235 /**
2236 * This is meant to be used by time(), date(), and timeanddate() to get
2237 * the date preference they're supposed to use, it should be used in
2238 * all children.
2239 *
2240 *<code>
2241 * function timeanddate([...], $format = true) {
2242 * $datePreference = $this->dateFormat($format);
2243 * [...]
2244 * }
2245 *</code>
2246 *
2247 * @param int|string|bool $usePrefs If true, the user's preference is used
2248 * if false, the site/language default is used
2249 * if int/string, assumed to be a format.
2250 * @return string
2251 */
2252 function dateFormat( $usePrefs = true ) {
2253 global $wgUser;
2254
2255 if ( is_bool( $usePrefs ) ) {
2256 if ( $usePrefs ) {
2257 $datePreference = $wgUser->getDatePreference();
2258 } else {
2259 $datePreference = (string)User::getDefaultOption( 'date' );
2260 }
2261 } else {
2262 $datePreference = (string)$usePrefs;
2263 }
2264
2265 // return int
2266 if ( $datePreference == '' ) {
2267 return 'default';
2268 }
2269
2270 return $datePreference;
2271 }
2272
2273 /**
2274 * Get a format string for a given type and preference
2275 * @param string $type May be 'date', 'time', 'both', or 'pretty'.
2276 * @param string $pref The format name as it appears in Messages*.php under
2277 * $datePreferences.
2278 *
2279 * @since 1.22 New type 'pretty' that provides a more readable timestamp format
2280 *
2281 * @return string
2282 */
2283 function getDateFormatString( $type, $pref ) {
2284 $wasDefault = false;
2285 if ( $pref == 'default' ) {
2286 $wasDefault = true;
2287 $pref = $this->getDefaultDateFormat();
2288 }
2289
2290 if ( !isset( $this->dateFormatStrings[$type][$pref] ) ) {
2291 $df = self::$dataCache->getSubitem( $this->mCode, 'dateFormats', "$pref $type" );
2292
2293 if ( $type === 'pretty' && $df === null ) {
2294 $df = $this->getDateFormatString( 'date', $pref );
2295 }
2296
2297 if ( !$wasDefault && $df === null ) {
2298 $pref = $this->getDefaultDateFormat();
2299 $df = self::$dataCache->getSubitem( $this->mCode, 'dateFormats', "$pref $type" );
2300 }
2301
2302 $this->dateFormatStrings[$type][$pref] = $df;
2303 }
2304 return $this->dateFormatStrings[$type][$pref];
2305 }
2306
2307 /**
2308 * @param string $ts The time format which needs to be turned into a
2309 * date('YmdHis') format with wfTimestamp(TS_MW,$ts)
2310 * @param bool $adj Whether to adjust the time output according to the
2311 * user configured offset ($timecorrection)
2312 * @param mixed $format True to use user's date format preference
2313 * @param string|bool $timecorrection The time offset as returned by
2314 * validateTimeZone() in Special:Preferences
2315 * @return string
2316 */
2317 function date( $ts, $adj = false, $format = true, $timecorrection = false ) {
2318 $ts = wfTimestamp( TS_MW, $ts );
2319 if ( $adj ) {
2320 $ts = $this->userAdjust( $ts, $timecorrection );
2321 }
2322 $df = $this->getDateFormatString( 'date', $this->dateFormat( $format ) );
2323 return $this->sprintfDate( $df, $ts );
2324 }
2325
2326 /**
2327 * @param string $ts The time format which needs to be turned into a
2328 * date('YmdHis') format with wfTimestamp(TS_MW,$ts)
2329 * @param bool $adj Whether to adjust the time output according to the
2330 * user configured offset ($timecorrection)
2331 * @param mixed $format True to use user's date format preference
2332 * @param string|bool $timecorrection The time offset as returned by
2333 * validateTimeZone() in Special:Preferences
2334 * @return string
2335 */
2336 function time( $ts, $adj = false, $format = true, $timecorrection = false ) {
2337 $ts = wfTimestamp( TS_MW, $ts );
2338 if ( $adj ) {
2339 $ts = $this->userAdjust( $ts, $timecorrection );
2340 }
2341 $df = $this->getDateFormatString( 'time', $this->dateFormat( $format ) );
2342 return $this->sprintfDate( $df, $ts );
2343 }
2344
2345 /**
2346 * @param string $ts The time format which needs to be turned into a
2347 * date('YmdHis') format with wfTimestamp(TS_MW,$ts)
2348 * @param bool $adj Whether to adjust the time output according to the
2349 * user configured offset ($timecorrection)
2350 * @param mixed $format What format to return, if it's false output the
2351 * default one (default true)
2352 * @param string|bool $timecorrection The time offset as returned by
2353 * validateTimeZone() in Special:Preferences
2354 * @return string
2355 */
2356 function timeanddate( $ts, $adj = false, $format = true, $timecorrection = false ) {
2357 $ts = wfTimestamp( TS_MW, $ts );
2358 if ( $adj ) {
2359 $ts = $this->userAdjust( $ts, $timecorrection );
2360 }
2361 $df = $this->getDateFormatString( 'both', $this->dateFormat( $format ) );
2362 return $this->sprintfDate( $df, $ts );
2363 }
2364
2365 /**
2366 * Takes a number of seconds and turns it into a text using values such as hours and minutes.
2367 *
2368 * @since 1.20
2369 *
2370 * @param int $seconds The amount of seconds.
2371 * @param array $chosenIntervals The intervals to enable.
2372 *
2373 * @return string
2374 */
2375 public function formatDuration( $seconds, array $chosenIntervals = array() ) {
2376 $intervals = $this->getDurationIntervals( $seconds, $chosenIntervals );
2377
2378 $segments = array();
2379
2380 foreach ( $intervals as $intervalName => $intervalValue ) {
2381 // Messages: duration-seconds, duration-minutes, duration-hours, duration-days, duration-weeks,
2382 // duration-years, duration-decades, duration-centuries, duration-millennia
2383 $message = wfMessage( 'duration-' . $intervalName )->numParams( $intervalValue );
2384 $segments[] = $message->inLanguage( $this )->escaped();
2385 }
2386
2387 return $this->listToText( $segments );
2388 }
2389
2390 /**
2391 * Takes a number of seconds and returns an array with a set of corresponding intervals.
2392 * For example 65 will be turned into array( minutes => 1, seconds => 5 ).
2393 *
2394 * @since 1.20
2395 *
2396 * @param int $seconds The amount of seconds.
2397 * @param array $chosenIntervals The intervals to enable.
2398 *
2399 * @return array
2400 */
2401 public function getDurationIntervals( $seconds, array $chosenIntervals = array() ) {
2402 if ( empty( $chosenIntervals ) ) {
2403 $chosenIntervals = array(
2404 'millennia',
2405 'centuries',
2406 'decades',
2407 'years',
2408 'days',
2409 'hours',
2410 'minutes',
2411 'seconds'
2412 );
2413 }
2414
2415 $intervals = array_intersect_key( self::$durationIntervals, array_flip( $chosenIntervals ) );
2416 $sortedNames = array_keys( $intervals );
2417 $smallestInterval = array_pop( $sortedNames );
2418
2419 $segments = array();
2420
2421 foreach ( $intervals as $name => $length ) {
2422 $value = floor( $seconds / $length );
2423
2424 if ( $value > 0 || ( $name == $smallestInterval && empty( $segments ) ) ) {
2425 $seconds -= $value * $length;
2426 $segments[$name] = $value;
2427 }
2428 }
2429
2430 return $segments;
2431 }
2432
2433 /**
2434 * Internal helper function for userDate(), userTime() and userTimeAndDate()
2435 *
2436 * @param string $type Can be 'date', 'time' or 'both'
2437 * @param string $ts The time format which needs to be turned into a
2438 * date('YmdHis') format with wfTimestamp(TS_MW,$ts)
2439 * @param User $user User object used to get preferences for timezone and format
2440 * @param array $options Array, can contain the following keys:
2441 * - 'timecorrection': time correction, can have the following values:
2442 * - true: use user's preference
2443 * - false: don't use time correction
2444 * - int: value of time correction in minutes
2445 * - 'format': format to use, can have the following values:
2446 * - true: use user's preference
2447 * - false: use default preference
2448 * - string: format to use
2449 * @since 1.19
2450 * @return string
2451 */
2452 private function internalUserTimeAndDate( $type, $ts, User $user, array $options ) {
2453 $ts = wfTimestamp( TS_MW, $ts );
2454 $options += array( 'timecorrection' => true, 'format' => true );
2455 if ( $options['timecorrection'] !== false ) {
2456 if ( $options['timecorrection'] === true ) {
2457 $offset = $user->getOption( 'timecorrection' );
2458 } else {
2459 $offset = $options['timecorrection'];
2460 }
2461 $ts = $this->userAdjust( $ts, $offset );
2462 }
2463 if ( $options['format'] === true ) {
2464 $format = $user->getDatePreference();
2465 } else {
2466 $format = $options['format'];
2467 }
2468 $df = $this->getDateFormatString( $type, $this->dateFormat( $format ) );
2469 return $this->sprintfDate( $df, $ts );
2470 }
2471
2472 /**
2473 * Get the formatted date for the given timestamp and formatted for
2474 * the given user.
2475 *
2476 * @param mixed $ts Mixed: the time format which needs to be turned into a
2477 * date('YmdHis') format with wfTimestamp(TS_MW,$ts)
2478 * @param User $user User object used to get preferences for timezone and format
2479 * @param array $options Array, can contain the following keys:
2480 * - 'timecorrection': time correction, can have the following values:
2481 * - true: use user's preference
2482 * - false: don't use time correction
2483 * - int: value of time correction in minutes
2484 * - 'format': format to use, can have the following values:
2485 * - true: use user's preference
2486 * - false: use default preference
2487 * - string: format to use
2488 * @since 1.19
2489 * @return string
2490 */
2491 public function userDate( $ts, User $user, array $options = array() ) {
2492 return $this->internalUserTimeAndDate( 'date', $ts, $user, $options );
2493 }
2494
2495 /**
2496 * Get the formatted time for the given timestamp and formatted for
2497 * the given user.
2498 *
2499 * @param mixed $ts The time format which needs to be turned into a
2500 * date('YmdHis') format with wfTimestamp(TS_MW,$ts)
2501 * @param User $user User object used to get preferences for timezone and format
2502 * @param array $options Array, can contain the following keys:
2503 * - 'timecorrection': time correction, can have the following values:
2504 * - true: use user's preference
2505 * - false: don't use time correction
2506 * - int: value of time correction in minutes
2507 * - 'format': format to use, can have the following values:
2508 * - true: use user's preference
2509 * - false: use default preference
2510 * - string: format to use
2511 * @since 1.19
2512 * @return string
2513 */
2514 public function userTime( $ts, User $user, array $options = array() ) {
2515 return $this->internalUserTimeAndDate( 'time', $ts, $user, $options );
2516 }
2517
2518 /**
2519 * Get the formatted date and time for the given timestamp and formatted for
2520 * the given user.
2521 *
2522 * @param mixed $ts The time format which needs to be turned into a
2523 * date('YmdHis') format with wfTimestamp(TS_MW,$ts)
2524 * @param User $user User object used to get preferences for timezone and format
2525 * @param array $options Array, can contain the following keys:
2526 * - 'timecorrection': time correction, can have the following values:
2527 * - true: use user's preference
2528 * - false: don't use time correction
2529 * - int: value of time correction in minutes
2530 * - 'format': format to use, can have the following values:
2531 * - true: use user's preference
2532 * - false: use default preference
2533 * - string: format to use
2534 * @since 1.19
2535 * @return string
2536 */
2537 public function userTimeAndDate( $ts, User $user, array $options = array() ) {
2538 return $this->internalUserTimeAndDate( 'both', $ts, $user, $options );
2539 }
2540
2541 /**
2542 * Get the timestamp in a human-friendly relative format, e.g., "3 days ago".
2543 *
2544 * Determine the difference between the timestamp and the current time, and
2545 * generate a readable timestamp by returning "<N> <units> ago", where the
2546 * largest possible unit is used.
2547 *
2548 * @since 1.26 (Prior to 1.26 method existed but was not meant to be used directly)
2549 *
2550 * @param MWTimestamp $time
2551 * @param MWTimestamp|null $relativeTo The base timestamp to compare to (defaults to now)
2552 * @param User|null $user User the timestamp is being generated for (or null to use main context's user)
2553 * @return string Formatted timestamp
2554 */
2555 public function getHumanTimestamp( MWTimestamp $time, MWTimestamp $relativeTo = null, User $user = null ) {
2556 if ( $relativeTo === null ) {
2557 $relativeTo = new MWTimestamp();
2558 }
2559 if ( $user === null ) {
2560 $user = RequestContext::getMain()->getUser();
2561 }
2562
2563 // Adjust for the user's timezone.
2564 $offsetThis = $time->offsetForUser( $user );
2565 $offsetRel = $relativeTo->offsetForUser( $user );
2566
2567 $ts = '';
2568 if ( Hooks::run( 'GetHumanTimestamp', array( &$ts, $time, $relativeTo, $user, $this ) ) ) {
2569 $ts = $this->getHumanTimestampInternal( $time, $relativeTo, $user );
2570 }
2571
2572 // Reset the timezone on the objects.
2573 $time->timestamp->sub( $offsetThis );
2574 $relativeTo->timestamp->sub( $offsetRel );
2575
2576 return $ts;
2577 }
2578
2579 /**
2580 * Convert an MWTimestamp into a pretty human-readable timestamp using
2581 * the given user preferences and relative base time.
2582 *
2583 * @see Language::getHumanTimestamp
2584 * @param MWTimestamp $ts Timestamp to prettify
2585 * @param MWTimestamp $relativeTo Base timestamp
2586 * @param User $user User preferences to use
2587 * @return string Human timestamp
2588 * @since 1.26
2589 */
2590 private function getHumanTimestampInternal( MWTimestamp $ts, MWTimestamp $relativeTo, User $user ) {
2591 $diff = $ts->diff( $relativeTo );
2592 $diffDay = (bool)( (int)$ts->timestamp->format( 'w' ) -
2593 (int)$relativeTo->timestamp->format( 'w' ) );
2594 $days = $diff->days ?: (int)$diffDay;
2595 if ( $diff->invert || $days > 5
2596 && $ts->timestamp->format( 'Y' ) !== $relativeTo->timestamp->format( 'Y' )
2597 ) {
2598 // Timestamps are in different years: use full timestamp
2599 // Also do full timestamp for future dates
2600 /**
2601 * @todo FIXME: Add better handling of future timestamps.
2602 */
2603 $format = $this->getDateFormatString( 'both', $user->getDatePreference() ?: 'default' );
2604 $ts = $this->sprintfDate( $format, $ts->getTimestamp( TS_MW ) );
2605 } elseif ( $days > 5 ) {
2606 // Timestamps are in same year, but more than 5 days ago: show day and month only.
2607 $format = $this->getDateFormatString( 'pretty', $user->getDatePreference() ?: 'default' );
2608 $ts = $this->sprintfDate( $format, $ts->getTimestamp( TS_MW ) );
2609 } elseif ( $days > 1 ) {
2610 // Timestamp within the past week: show the day of the week and time
2611 $format = $this->getDateFormatString( 'time', $user->getDatePreference() ?: 'default' );
2612 $weekday = self::$mWeekdayMsgs[$ts->timestamp->format( 'w' )];
2613 // Messages:
2614 // sunday-at, monday-at, tuesday-at, wednesday-at, thursday-at, friday-at, saturday-at
2615 $ts = wfMessage( "$weekday-at" )
2616 ->inLanguage( $this )
2617 ->params( $this->sprintfDate( $format, $ts->getTimestamp( TS_MW ) ) )
2618 ->text();
2619 } elseif ( $days == 1 ) {
2620 // Timestamp was yesterday: say 'yesterday' and the time.
2621 $format = $this->getDateFormatString( 'time', $user->getDatePreference() ?: 'default' );
2622 $ts = wfMessage( 'yesterday-at' )
2623 ->inLanguage( $this )
2624 ->params( $this->sprintfDate( $format, $ts->getTimestamp( TS_MW ) ) )
2625 ->text();
2626 } elseif ( $diff->h > 1 || $diff->h == 1 && $diff->i > 30 ) {
2627 // Timestamp was today, but more than 90 minutes ago: say 'today' and the time.
2628 $format = $this->getDateFormatString( 'time', $user->getDatePreference() ?: 'default' );
2629 $ts = wfMessage( 'today-at' )
2630 ->inLanguage( $this )
2631 ->params( $this->sprintfDate( $format, $ts->getTimestamp( TS_MW ) ) )
2632 ->text();
2633
2634 // From here on in, the timestamp was soon enough ago so that we can simply say
2635 // XX units ago, e.g., "2 hours ago" or "5 minutes ago"
2636 } elseif ( $diff->h == 1 ) {
2637 // Less than 90 minutes, but more than an hour ago.
2638 $ts = wfMessage( 'hours-ago' )->inLanguage( $this )->numParams( 1 )->text();
2639 } elseif ( $diff->i >= 1 ) {
2640 // A few minutes ago.
2641 $ts = wfMessage( 'minutes-ago' )->inLanguage( $this )->numParams( $diff->i )->text();
2642 } elseif ( $diff->s >= 30 ) {
2643 // Less than a minute, but more than 30 sec ago.
2644 $ts = wfMessage( 'seconds-ago' )->inLanguage( $this )->numParams( $diff->s )->text();
2645 } else {
2646 // Less than 30 seconds ago.
2647 $ts = wfMessage( 'just-now' )->text();
2648 }
2649
2650 return $ts;
2651 }
2652
2653 /**
2654 * @param string $key
2655 * @return array|null
2656 */
2657 function getMessage( $key ) {
2658 return self::$dataCache->getSubitem( $this->mCode, 'messages', $key );
2659 }
2660
2661 /**
2662 * @return array
2663 */
2664 function getAllMessages() {
2665 return self::$dataCache->getItem( $this->mCode, 'messages' );
2666 }
2667
2668 /**
2669 * @param string $in
2670 * @param string $out
2671 * @param string $string
2672 * @return string
2673 */
2674 function iconv( $in, $out, $string ) {
2675 # This is a wrapper for iconv in all languages except esperanto,
2676 # which does some nasty x-conversions beforehand
2677
2678 # Even with //IGNORE iconv can whine about illegal characters in
2679 # *input* string. We just ignore those too.
2680 # REF: http://bugs.php.net/bug.php?id=37166
2681 # REF: https://bugzilla.wikimedia.org/show_bug.cgi?id=16885
2682 MediaWiki\suppressWarnings();
2683 $text = iconv( $in, $out . '//IGNORE', $string );
2684 MediaWiki\restoreWarnings();
2685 return $text;
2686 }
2687
2688 // callback functions for uc(), lc(), ucwords(), ucwordbreaks()
2689
2690 /**
2691 * @param array $matches
2692 * @return mixed|string
2693 */
2694 function ucwordbreaksCallbackAscii( $matches ) {
2695 return $this->ucfirst( $matches[1] );
2696 }
2697
2698 /**
2699 * @param array $matches
2700 * @return string
2701 */
2702 function ucwordbreaksCallbackMB( $matches ) {
2703 return mb_strtoupper( $matches[0] );
2704 }
2705
2706 /**
2707 * @param array $matches
2708 * @return string
2709 */
2710 function ucCallback( $matches ) {
2711 list( $wikiUpperChars ) = self::getCaseMaps();
2712 return strtr( $matches[1], $wikiUpperChars );
2713 }
2714
2715 /**
2716 * @param array $matches
2717 * @return string
2718 */
2719 function lcCallback( $matches ) {
2720 list( , $wikiLowerChars ) = self::getCaseMaps();
2721 return strtr( $matches[1], $wikiLowerChars );
2722 }
2723
2724 /**
2725 * @param array $matches
2726 * @return string
2727 */
2728 function ucwordsCallbackMB( $matches ) {
2729 return mb_strtoupper( $matches[0] );
2730 }
2731
2732 /**
2733 * @param array $matches
2734 * @return string
2735 */
2736 function ucwordsCallbackWiki( $matches ) {
2737 list( $wikiUpperChars ) = self::getCaseMaps();
2738 return strtr( $matches[0], $wikiUpperChars );
2739 }
2740
2741 /**
2742 * Make a string's first character uppercase
2743 *
2744 * @param string $str
2745 *
2746 * @return string
2747 */
2748 function ucfirst( $str ) {
2749 $o = ord( $str );
2750 if ( $o < 96 ) { // if already uppercase...
2751 return $str;
2752 } elseif ( $o < 128 ) {
2753 return ucfirst( $str ); // use PHP's ucfirst()
2754 } else {
2755 // fall back to more complex logic in case of multibyte strings
2756 return $this->uc( $str, true );
2757 }
2758 }
2759
2760 /**
2761 * Convert a string to uppercase
2762 *
2763 * @param string $str
2764 * @param bool $first
2765 *
2766 * @return string
2767 */
2768 function uc( $str, $first = false ) {
2769 if ( function_exists( 'mb_strtoupper' ) ) {
2770 if ( $first ) {
2771 if ( $this->isMultibyte( $str ) ) {
2772 return mb_strtoupper( mb_substr( $str, 0, 1 ) ) . mb_substr( $str, 1 );
2773 } else {
2774 return ucfirst( $str );
2775 }
2776 } else {
2777 return $this->isMultibyte( $str ) ? mb_strtoupper( $str ) : strtoupper( $str );
2778 }
2779 } else {
2780 if ( $this->isMultibyte( $str ) ) {
2781 $x = $first ? '^' : '';
2782 return preg_replace_callback(
2783 "/$x([a-z]|[\\xc0-\\xff][\\x80-\\xbf]*)/",
2784 array( $this, 'ucCallback' ),
2785 $str
2786 );
2787 } else {
2788 return $first ? ucfirst( $str ) : strtoupper( $str );
2789 }
2790 }
2791 }
2792
2793 /**
2794 * @param string $str
2795 * @return mixed|string
2796 */
2797 function lcfirst( $str ) {
2798 $o = ord( $str );
2799 if ( !$o ) {
2800 return strval( $str );
2801 } elseif ( $o >= 128 ) {
2802 return $this->lc( $str, true );
2803 } elseif ( $o > 96 ) {
2804 return $str;
2805 } else {
2806 $str[0] = strtolower( $str[0] );
2807 return $str;
2808 }
2809 }
2810
2811 /**
2812 * @param string $str
2813 * @param bool $first
2814 * @return mixed|string
2815 */
2816 function lc( $str, $first = false ) {
2817 if ( function_exists( 'mb_strtolower' ) ) {
2818 if ( $first ) {
2819 if ( $this->isMultibyte( $str ) ) {
2820 return mb_strtolower( mb_substr( $str, 0, 1 ) ) . mb_substr( $str, 1 );
2821 } else {
2822 return strtolower( substr( $str, 0, 1 ) ) . substr( $str, 1 );
2823 }
2824 } else {
2825 return $this->isMultibyte( $str ) ? mb_strtolower( $str ) : strtolower( $str );
2826 }
2827 } else {
2828 if ( $this->isMultibyte( $str ) ) {
2829 $x = $first ? '^' : '';
2830 return preg_replace_callback(
2831 "/$x([A-Z]|[\\xc0-\\xff][\\x80-\\xbf]*)/",
2832 array( $this, 'lcCallback' ),
2833 $str
2834 );
2835 } else {
2836 return $first ? strtolower( substr( $str, 0, 1 ) ) . substr( $str, 1 ) : strtolower( $str );
2837 }
2838 }
2839 }
2840
2841 /**
2842 * @param string $str
2843 * @return bool
2844 */
2845 function isMultibyte( $str ) {
2846 return strlen( $str ) !== mb_strlen( $str );
2847 }
2848
2849 /**
2850 * @param string $str
2851 * @return mixed|string
2852 */
2853 function ucwords( $str ) {
2854 if ( $this->isMultibyte( $str ) ) {
2855 $str = $this->lc( $str );
2856
2857 // regexp to find first letter in each word (i.e. after each space)
2858 $replaceRegexp = "/^([a-z]|[\\xc0-\\xff][\\x80-\\xbf]*)| ([a-z]|[\\xc0-\\xff][\\x80-\\xbf]*)/";
2859