reference/mbstring/functions/mb-convert-case.xml
b4afab59db15ea4b7c5dc2132d85932b4859bcf2
...
...
@@ -10,9 +10,9 @@
10
10
&reftitle.description;
11
11
<methodsynopsis>
12
12
<type>string</type><methodname>mb_convert_case</methodname>
13
-
<methodparam><type>string</type><parameter>str</parameter></methodparam>
13
+
<methodparam><type>string</type><parameter>string</parameter></methodparam>
14
14
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
15
-
<methodparam choice="opt"><type>string</type><parameter>encoding</parameter><initializer>mb_internal_encoding()</initializer></methodparam>
15
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
16
16
</methodsynopsis>
17
17
<para>
18
18
Performs case folding on a <type>string</type>, converted in the way specified by
...
...
@@ -25,7 +25,7 @@
25
25
<para>
26
26
<variablelist>
27
27
<varlistentry>
28
-
<term><parameter>str</parameter></term>
28
+
<term><parameter>string</parameter></term>
29
29
<listitem>
30
30
<para>
31
31
The <type>string</type> being converted.
...
...
@@ -38,8 +38,13 @@
38
38
<para>
39
39
The mode of the conversion. It can be one of
40
40
<constant>MB_CASE_UPPER</constant>,
41
-
<constant>MB_CASE_LOWER</constant>, or
42
-
<constant>MB_CASE_TITLE</constant>.
41
+
<constant>MB_CASE_LOWER</constant>,
42
+
<constant>MB_CASE_TITLE</constant>,
43
+
<constant>MB_CASE_FOLD</constant>,
44
+
<constant>MB_CASE_UPPER_SIMPLE</constant>,
45
+
<constant>MB_CASE_LOWER_SIMPLE</constant>,
46
+
<constant>MB_CASE_TITLE_SIMPLE</constant>,
47
+
<constant>MB_CASE_FOLD_SIMPLE</constant>.
43
48
</para>
44
49
</listitem>
45
50
</varlistentry>
...
...
@@ -61,19 +66,33 @@
61
66
</para>
62
67
</refsect1>
63
68

64
-
<refsect1 role="unicode">
65
-
&reftitle.unicode;
69
+
<refsect1 role="changelog">
70
+
&reftitle.changelog;
66
71
<para>
67
-
By contrast to the standard case folding functions such as
68
-
<function>strtolower</function> and <function>strtoupper</function>,
69
-
case folding is performed on the basis of the Unicode character
70
-
properties. Thus the behaviour of this function is not affected
71
-
by locale settings and it can convert any characters that have
72
-
'alphabetic' property, such as A-umlaut (Ä).
73
-
</para>
74
-
<para>
75
-
For more information about the Unicode properties, please see <link
76
-
xlink:href="&url.unicode.reports;">&url.unicode.reports;</link>.
72
+
<informaltable>
73
+
<tgroup cols="2">
74
+
<thead>
75
+
<row>
76
+
<entry>&Version;</entry>
77
+
<entry>&Description;</entry>
78
+
</row>
79
+
</thead>
80
+
<tbody>
81
+
<row>
82
+
<entry>7.3.0</entry>
83
+
<entry>
84
+
Added support for
85
+
<constant>MB_CASE_FOLD</constant>,
86
+
<constant>MB_CASE_UPPER_SIMPLE</constant>,
87
+
<constant>MB_CASE_LOWER_SIMPLE</constant>,
88
+
<constant>MB_CASE_TITLE_SIMPLE</constant>, and
89
+
<constant>MB_CASE_FOLD_SIMPLE</constant>
90
+
as <parameter>mode</parameter>.
91
+
</entry>
92
+
</row>
93
+
</tbody>
94
+
</tgroup>
95
+
</informaltable>
77
96
</para>
78
97
</refsect1>
79
98

...
...
@@ -114,6 +133,22 @@ echo $str; // Prints Τάχιστη Αλώπηξ Βαφήσ Ψημένη Γη,
114
133
</para>
115
134
</refsect1>
116
135

136
+
<refsect1 role="notes">
137
+
&reftitle.notes;
138
+
<para>
139
+
By contrast to the standard case folding functions such as
140
+
<function>strtolower</function> and <function>strtoupper</function>,
141
+
case folding is performed on the basis of the Unicode character
142
+
properties. Thus the behaviour of this function is not affected
143
+
by locale settings and it can convert any characters that have
144
+
'alphabetic' property, such a-umlaut (ä).
145
+
</para>
146
+
<para>
147
+
For more information about the Unicode properties, please see <link
148
+
xlink:href="&url.unicode.reports;">&url.unicode.reports;</link>.
149
+
</para>
150
+
</refsect1>
151
+

117
152
<refsect1 role="seealso">
118
153
&reftitle.seealso;
119
154
<para>
...
...
@@ -128,7 +163,6 @@ echo $str; // Prints Τάχιστη Αλώπηξ Βαφήσ Ψημένη Γη,
128
163
</para>
129
164
</refsect1>
130
165
</refentry>
131
-

132
166
<!-- Keep this comment at the end of the file
133
167
Local variables:
134
168
mode: sgml
135
169