1TOLOWER(P)                 POSIX Programmer's Manual                TOLOWER(P)
2
3
4

NAME

6       tolower - transliterate uppercase characters to lowercase
7

SYNOPSIS

9       #include <ctype.h>
10
11       int tolower(int c);
12
13

DESCRIPTION

15       The  tolower()  function has as a domain a type int, the value of which
16       is representable as an unsigned char or the value of EOF. If the  argu‐
17       ment has any other value, the behavior is undefined. If the argument of
18       tolower() represents an uppercase letter, and  there  exists  a  corre‐
19       sponding lowercase letter  (as defined by character type information in
20       the program locale category LC_CTYPE ),  the result shall be the corre‐
21       sponding  lowercase  letter.  All  other  arguments  in  the domain are
22       returned unchanged.
23

RETURN VALUE

25       Upon successful completion, tolower() shall return the lowercase letter
26       corresponding  to  the  argument passed; otherwise, it shall return the
27       argument unchanged.
28

ERRORS

30       No errors are defined.
31
32       The following sections are informative.
33

EXAMPLES

35       None.
36

APPLICATION USAGE

38       None.
39

RATIONALE

41       None.
42

FUTURE DIRECTIONS

44       None.
45

SEE ALSO

47       setlocale() , the  Base  Definitions  volume  of  IEEE Std 1003.1-2001,
48       Chapter 7, Locale, <ctype.h>
49
51       Portions  of  this text are reprinted and reproduced in electronic form
52       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
53       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
54       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
55       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the
56       event of any discrepancy between this version and the original IEEE and
57       The  Open Group Standard, the original IEEE and The Open Group Standard
58       is the referee document. The original Standard can be  obtained  online
59       at http://www.opengroup.org/unix/online.html .
60
61
62
63IEEE/The Open Group                  2003                           TOLOWER(P)
Impressum