reference/mbstring/functions/mb-language.xml
92f1b8b177eb5730382abf9f27bae868f1bb636f
92f1b8b177eb5730382abf9f27bae868f1bb636f
...
...
@@ -9,8 +9,8 @@
9
9
<refsect1 role="description">
10
10
&reftitle.description;
11
11
<methodsynopsis>
12
-
<type>mixed</type><methodname>mb_language</methodname>
13
-
<methodparam choice="opt"><type>string</type><parameter>language</parameter><initializer>mb_language()</initializer></methodparam>
12
+
<type class="union"><type>string</type><type>bool</type></type><methodname>mb_language</methodname>
13
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>language</parameter><initializer>&null;</initializer></methodparam>
14
14
</methodsynopsis>
15
15
<para>
16
16
Set/Get the current language.
...
...
@@ -25,17 +25,96 @@
25
25
<term><parameter>language</parameter></term>
26
26
<listitem>
27
27
<para>
28
-
Used for encoding
29
-
e-mail messages. Valid languages are "Japanese",
30
-
"ja","English","en" and "uni"
31
-
(UTF-8). <function>mb_send_mail</function> uses this setting to
32
-
encode e-mail.
33
-
</para>
34
-
<para>
35
-
Language and its setting is ISO-2022-JP/Base64 for
36
-
Japanese, UTF-8/Base64 for uni, ISO-8859-1/quoted printable for
37
-
English.
28
+
Used for encoding e-mail messages.
29
+
The valid languages are listed in the following table.
30
+
<function>mb_send_mail</function> uses this setting to encode e-mail.
38
31
</para>
32
+
<informaltable>
33
+
<tgroup cols="4">
34
+
<thead>
35
+
<row>
36
+
<entry>Language</entry>
37
+
<entry>Charset</entry>
38
+
<entry>Encoding</entry>
39
+
<entry>Alias</entry>
40
+
</row>
41
+
</thead>
42
+
<tbody>
43
+
<row>
44
+
<entry>German/de</entry>
45
+
<entry>ISO-8859-15</entry>
46
+
<entry>Quoted-Printable</entry>
47
+
<entry>Deutsch</entry>
48
+
</row>
49
+
<row>
50
+
<entry>English/en</entry>
51
+
<entry>ISO-8859-1</entry>
52
+
<entry>Quoted-Printable</entry>
53
+
<entry></entry>
54
+
</row>
55
+
<row>
56
+
<entry>Armenian/hy</entry>
57
+
<entry>ArmSCII-8</entry>
58
+
<entry>Quoted-Printable</entry>
59
+
<entry></entry>
60
+
</row>
61
+
<row>
62
+
<entry>Japanese/ja</entry>
63
+
<entry>ISO-2022-JP</entry>
64
+
<entry>BASE64</entry>
65
+
<entry></entry>
66
+
</row>
67
+
<row>
68
+
<entry>Korean/ko</entry>
69
+
<entry>ISO-2022-KR</entry>
70
+
<entry>BASE64</entry>
71
+
<entry></entry>
72
+
</row>
73
+
<row>
74
+
<entry>neutral</entry>
75
+
<entry>UTF-8</entry>
76
+
<entry>BASE64</entry>
77
+
<entry></entry>
78
+
</row>
79
+
<row>
80
+
<entry>Russian/ru</entry>
81
+
<entry>KOI8-R</entry>
82
+
<entry>Quoted-Printable</entry>
83
+
<entry></entry>
84
+
</row>
85
+
<row>
86
+
<entry>Turkish/tr</entry>
87
+
<entry>ISO-8859-9</entry>
88
+
<entry>Quoted-Printable</entry>
89
+
<entry></entry>
90
+
</row>
91
+
<row>
92
+
<entry>Ukrainian/ua</entry>
93
+
<entry>KOI8-U</entry>
94
+
<entry>Quoted-Printable</entry>
95
+
<entry></entry>
96
+
</row>
97
+
<row>
98
+
<entry>uni</entry>
99
+
<entry>UTF-8</entry>
100
+
<entry>BASE64</entry>
101
+
<entry>universal</entry>
102
+
</row>
103
+
<row>
104
+
<entry>Simplified Chinese/zh-cn</entry>
105
+
<entry>HZ</entry>
106
+
<entry>BASE64</entry>
107
+
<entry></entry>
108
+
</row>
109
+
<row>
110
+
<entry>Traditional Chinese/zh-tw</entry>
111
+
<entry>BIG-5</entry>
112
+
<entry>BASE64</entry>
113
+
<entry></entry>
114
+
</row>
115
+
</tbody>
116
+
</tgroup>
117
+
</informaltable>
39
118
</listitem>
40
119
</varlistentry>
41
120
</variablelist>
...
...
@@ -48,12 +127,33 @@
48
127
If <parameter>language</parameter> is set and
49
128
<parameter>language</parameter> is valid, it returns
50
129
&true;. Otherwise, it returns &false;.
51
-
When <parameter>language</parameter> is omitted, it returns the language
52
-
name as a <type>string</type>. If no language is set previously, it then returns
53
-
&false;.
130
+
When <parameter>language</parameter> is omitted or &null;, it returns the language
131
+
name as a <type>string</type>.
54
132
</para>
55
133
</refsect1>
56
134
135
+
<refsect1 role="changelog">
136
+
&reftitle.changelog;
137
+
<informaltable>
138
+
<tgroup cols="2">
139
+
<thead>
140
+
<row>
141
+
<entry>&Version;</entry>
142
+
<entry>&Description;</entry>
143
+
</row>
144
+
</thead>
145
+
<tbody>
146
+
<row>
147
+
<entry>8.0.0</entry>
148
+
<entry>
149
+
<parameter>language</parameter> is nullable now.
150
+
</entry>
151
+
</row>
152
+
</tbody>
153
+
</tgroup>
154
+
</informaltable>
155
+
</refsect1>
156
+
57
157
<refsect1 role="seealso">
58
158
&reftitle.seealso;
59
159
<para>
...
...
@@ -64,7 +164,6 @@
64
164
</refsect1>
65
165
66
166
</refentry>
67
-
68
167
<!-- Keep this comment at the end of the file
69
168
Local variables:
70
169
mode: sgml
71
170