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

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
line wrap: on
line source

<refentry id="toupper">
<refnamediv>
<refname>Toupper</refname>
<refname>Tolower</refname>
<refpurpose>character translation</refpurpose>
</refnamediv>

<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
#include &lt;ctype.h&gt;
</funcsynopsisinfo>
<funcprototype>
  <funcdef><function>toupper</function></funcdef>
  <paramdef>int <parameter>c</parameter></paramdef>
</funcprototype>
<funcprototype>
  <funcdef><function>tolower</function></funcdef>
  <paramdef>int <parameter>c</parameter></paramdef>
</funcprototype>
<funcprototype>
  <funcdef><function>_toupper</function></funcdef>
  <paramdef>int <parameter>c</parameter></paramdef>
</funcprototype>
<funcprototype>
  <funcdef><function>_tolower</function></funcdef>
  <paramdef>int <parameter>c</parameter></paramdef>
</funcprototype>
</funcsynopsis>

</refsynopsisdiv>

<refsect1><title>Description</title>
<para>
The functions toupper and tolower have as their domain the
integers in the range -1 to 255. Toupper converts lower-case
to upper-case, and tolower converts upper-case to lower-case.
All other arguments are returned unchanged.
</para>
<para>
The macros _toupper and _tolower do the same things as the
corresponding functions, but they have restricted domains and
they are faster. The argument to _toupper must be lower-case,
and the argument to _tolower must be upper-case. Arguments
that are outside each macros domain, such as passing a lower-case
to _tolower, yield garbage results.
</para>
</refsect1>
</refentry>