reference/strings/functions/strtolower.xml
54ff7bf8e0f8fa90988cccf6b583517366605f6d
...
...
@@ -10,16 +10,21 @@
10
10
&reftitle.description;
11
11
<methodsynopsis>
12
12
<type>string</type><methodname>strtolower</methodname>
13
-
<methodparam><type>string</type><parameter>str</parameter></methodparam>
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 lowercase.
18
18
</para>
19
19
<para>
20
-
Note that 'alphabetic' is determined by the current locale. This means
21
-
that in i.e. the default "C" locale, characters such as umlaut-A
22
-
(&Auml;) will not be converted.
20
+
Bytes in the range <literal>"A"</literal> (0x41) to <literal>"Z"</literal>
21
+
(0x5a) will be converted to the corresponding lowercase letter by adding 32
22
+
to 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_strtolower</function>.
23
28
</para>
24
29
</refsect1>
25
30

...
...
@@ -28,7 +33,7 @@
28
33
<para>
29
34
<variablelist>
30
35
<varlistentry>
31
-
<term><parameter>str</parameter></term>
36
+
<term><parameter>string</parameter></term>
32
37
<listitem>
33
38
<para>
34
39
The input string.
...
...
@@ -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