|
466
|
1 <refentry id="toupper">
|
|
|
2 <refnamediv>
|
|
579
|
3 <refname>Toupper</refname>
|
|
|
4 <refname>Tolower</refname>
|
|
|
5 <refpurpose>character translation</refpurpose>
|
|
466
|
6 </refnamediv>
|
|
|
7
|
|
|
8 <refsynopsisdiv>
|
|
|
9 <funcsynopsis>
|
|
468
|
10 <funcsynopsisinfo>
|
|
|
11 #include <ctype.h>
|
|
|
12 </funcsynopsisinfo>
|
|
466
|
13 <funcprototype>
|
|
|
14 <funcdef><function>toupper</function></funcdef>
|
|
474
|
15 <paramdef>int <parameter>c</parameter></paramdef>
|
|
|
16 </funcprototype>
|
|
|
17 <funcprototype>
|
|
|
18 <funcdef><function>tolower</function></funcdef>
|
|
|
19 <paramdef>int <parameter>c</parameter></paramdef>
|
|
|
20 </funcprototype>
|
|
|
21 <funcprototype>
|
|
|
22 <funcdef><function>_toupper</function></funcdef>
|
|
|
23 <paramdef>int <parameter>c</parameter></paramdef>
|
|
|
24 </funcprototype>
|
|
|
25 <funcprototype>
|
|
|
26 <funcdef><function>_tolower</function></funcdef>
|
|
|
27 <paramdef>int <parameter>c</parameter></paramdef>
|
|
466
|
28 </funcprototype>
|
|
|
29 </funcsynopsis>
|
|
|
30
|
|
|
31 </refsynopsisdiv>
|
|
|
32
|
|
|
33 <refsect1><title>Description</title>
|
|
|
34 <para>
|
|
474
|
35 The functions toupper and tolower have as their domain the
|
|
|
36 integers in the range -1 to 255. Toupper converts lower-case
|
|
|
37 to upper-case, and tolower converts upper-case to lower-case.
|
|
|
38 All other arguments are returned unchanged.
|
|
|
39 </para>
|
|
|
40 <para>
|
|
|
41 The macros _toupper and _tolower do the same things as the
|
|
|
42 corresponding functions, but they have restricted domains and
|
|
|
43 they are faster. The argument to _toupper must be lower-case,
|
|
|
44 and the argument to _tolower must be upper-case. Arguments
|
|
|
45 that are outside each macros domain, such as passing a lower-case
|
|
|
46 to _tolower, yield garbage results.
|
|
466
|
47 </para>
|
|
|
48 </refsect1>
|
|
|
49 </refentry>
|
