Mercurial > hg > Members > kono > nitros9-code

annotate docs/ccguide/toupper.refentry @ 2772:0a3f4d8ea6d5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Found ENDC in wrong location in dwread.asm and dwwrite.asm. Corrected. Moved the native 6309 code in dwread.asm and dwwrite.asm into the H6309 labeled area and changed IFEQ H6309 to IFNE H6309. Also moved the 57600bps 6809 code to the default location. This change had been done in the old dwread.asm and dwwrite.asm files to make it easier to follow. Though these two files were overwritten from the HDBDOS project dwread.asm and dwwrite.asm files. So this conversion needed to be done again so it made the source easier to follow.
author drencor-xeen
date Wed, 23 Jan 2013 12:36:55 -0600
parents dc9fb26efbad
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
1 <refentry id="toupper">
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
2 <refnamediv>
579
dc9fb26efbad All function prototypes are added.
roug
parents: 474
diff changeset
3 <refname>Toupper</refname>
dc9fb26efbad All function prototypes are added.
roug
parents: 474
diff changeset
4 <refname>Tolower</refname>
dc9fb26efbad All function prototypes are added.
roug
parents: 474
diff changeset
5 <refpurpose>character translation</refpurpose>
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
6 </refnamediv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
7
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
8 <refsynopsisdiv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
9 <funcsynopsis>
468
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
10 <funcsynopsisinfo>
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
11 #include &lt;ctype.h&gt;
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
12 </funcsynopsisinfo>
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
13 <funcprototype>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
14 <funcdef><function>toupper</function></funcdef>
474
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
15 <paramdef>int <parameter>c</parameter></paramdef>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
16 </funcprototype>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
17 <funcprototype>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
18 <funcdef><function>tolower</function></funcdef>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
19 <paramdef>int <parameter>c</parameter></paramdef>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
20 </funcprototype>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
21 <funcprototype>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
22 <funcdef><function>_toupper</function></funcdef>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
23 <paramdef>int <parameter>c</parameter></paramdef>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
24 </funcprototype>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
25 <funcprototype>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
26 <funcdef><function>_tolower</function></funcdef>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
27 <paramdef>int <parameter>c</parameter></paramdef>
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
28 </funcprototype>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
29 </funcsynopsis>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
30
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
31 </refsynopsisdiv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
32
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
33 <refsect1><title>Description</title>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
34 <para>
474
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
35 The functions toupper and tolower have as their domain the
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
36 integers in the range -1 to 255. Toupper converts lower-case
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
37 to upper-case, and tolower converts upper-case to lower-case.
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
38 All other arguments are returned unchanged.
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
39 </para>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
40 <para>
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
41 The macros _toupper and _tolower do the same things as the
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
42 corresponding functions, but they have restricted domains and
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
43 they are faster. The argument to _toupper must be lower-case,
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
44 and the argument to _tolower must be upper-case. Arguments
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
45 that are outside each macros domain, such as passing a lower-case
31ce96b2dc9d entered: chdir chmod qsort strass toupper tsleep wait
roug
parents: 468
diff changeset
46 to _tolower, yield garbage results.
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
47 </para>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
48 </refsect1>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
49 </refentry>