reference/strings/functions/strtoupper.xml
54ff7bf8e0f8fa90988cccf6b583517366605f6d
54ff7bf8e0f8fa90988cccf6b583517366605f6d
...
...
@@ -13,13 +13,18 @@
13
13
<methodparam><type>string</type><parameter>string</parameter></methodparam>
14
14
</methodsynopsis>
15
15
<para>
16
-
Returns <parameter>string</parameter> with all alphabetic characters
16
+
Returns <parameter>string</parameter> with all ASCII alphabetic characters
17
17
converted to uppercase.
18
18
</para>
19
19
<para>
20
-
Note that 'alphabetic' is determined by the current locale. For instance,
21
-
in the default "C" locale characters such as umlaut-a (ä) will not be
22
-
converted.
20
+
Bytes in the range <literal>"a"</literal> (0x61) to <literal>"z"</literal>
21
+
(0x7a) will be converted to the corresponding uppercase letter by subtracting
22
+
32 from each byte value.
23
+
</para>
24
+
<para>
25
+
This can be used to convert ASCII characters within strings encoded with
26
+
UTF-8, since multibyte UTF-8 characters will be ignored. To convert multibyte
27
+
non-ASCII characters, use <function>mb_strtoupper</function>.
23
28
</para>
24
29
</refsect1>
25
30
...
...
@@ -46,6 +51,23 @@
46
51
</para>
47
52
</refsect1>
48
53
54
+
<refsect1 role="changelog">
55
+
&reftitle.changelog;
56
+
<informaltable>
57
+
<tgroup cols="2">
58
+
<thead>
59
+
<row>
60
+
<entry>&Version;</entry>
61
+
<entry>&Description;</entry>
62
+
</row>
63
+
</thead>
64
+
<tbody>
65
+
&strings.changelog.ascii-case-conversion;
66
+
</tbody>
67
+
</tgroup>
68
+
</informaltable>
69
+
</refsect1>
70
+
49
71
<refsect1 role="examples">
50
72
&reftitle.examples;
51
73
<para>
52
74