man3p/tolower.3p

   1 .\" Copyright (c) 2001-2003 The Open Group, All Rights Reserved
   2 .TH "TOLOWER" P 2003 "IEEE/The Open Group" "POSIX Programmer's Manual"
   3 .\" tolower
   4 .SH NAME
   5 tolower \- transliterate uppercase characters to lowercase
   6 .SH SYNOPSIS
   7 .LP
   8 \fB#include <ctype.h>
   9 .br
  10 .sp
  11 int tolower(int\fP \fIc\fP\fB);
  12 .br
  13 \fP
  14 .SH DESCRIPTION
  15 .LP
  16 The \fItolower\fP() function has as a domain a type \fBint\fP, the
  17 value of which is representable as an \fBunsigned char\fP
  18 or the value of EOF. If the argument has any other value, the behavior
  19 is undefined. If the argument of \fItolower\fP() represents
  20 an uppercase letter, and there exists a corresponding lowercase letter
  21 \ (as defined by character type information in the program
  22 locale category \fILC_CTYPE ),\fP  the result shall be the
  23 corresponding lowercase letter. All other arguments in the domain
  24 are returned unchanged.
  25 .SH RETURN VALUE
  26 .LP
  27 Upon successful completion, \fItolower\fP() shall return the lowercase
  28 letter corresponding to the argument passed; otherwise,
  29 it shall return the argument unchanged.
  30 .SH ERRORS
  31 .LP
  32 No errors are defined.
  33 .LP
  34 \fIThe following sections are informative.\fP
  35 .SH EXAMPLES
  36 .LP
  37 None.
  38 .SH APPLICATION USAGE
  39 .LP
  40 None.
  41 .SH RATIONALE
  42 .LP
  43 None.
  44 .SH FUTURE DIRECTIONS
  45 .LP
  46 None.
  47 .SH SEE ALSO
  48 .LP
  49 \fIsetlocale\fP() , the Base Definitions volume of IEEE\ Std\ 1003.1-2001,
  50 Chapter 7, Locale, \fI<ctype.h>\fP
  51 .SH COPYRIGHT
  52 Portions of this text are reprinted and reproduced in electronic form
  53 from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
  54 -- Portable Operating System Interface (POSIX), The Open Group Base
  55 Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
  56 Electrical and Electronics Engineers, Inc and The Open Group. In the
  57 event of any discrepancy between this version and the original IEEE and
  58 The Open Group Standard, the original IEEE and The Open Group Standard
  59 is the referee document. The original Standard can be obtained online at
  60 http://www.opengroup.org/unix/online.html .