TOLOWER(3C) Standard C Library Functions TOLOWER(3C)
tolower, tolower_l - transliterate upper-case characters to lower-
case
#include <ctype.h>
int tolower(int c);
int tolower_l(int c, locale_t loc);
The tolower() function has as a domain of type int, the value of
which is representable as an unsigned char or the value of EOF. If
the argument has any other value, the argument is returned unchanged.
If the argument of tolower() represents an upper-case letter, and
there exists a corresponding lower-case letter (as defined by
character type information in the locale category LC_CTYPE), the
result is the corresponding lower-case letter. All other arguments in
the domain are returned unchanged.
The function tolower_l() behaves identically to tolower(), except
instead of operating in the current locale, it operates in the locale
specified by loc.
A macro form, _tolower() exists. It is defined for standards
conformance, particularly with legacy standards. It was deprecated in
POSIX 2008 (Issue 7), and its use is discouraged. The macro, on this
system, is just an alias for tolower().
On successful completion, tolower() returns the lower-case letter
corresponding to the argument passed. Otherwise, it returns the
argument unchanged.
No errors are defined.
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|CSI | Enabled |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
newlocale(3C), setlocale(3C), uselocale(3C), attributes(7),
standards(7)
October 4, 2015 TOLOWER(3C)
NAME
tolower, tolower_l - transliterate upper-case characters to lower-
case
SYNOPSIS
#include <ctype.h>
int tolower(int c);
int tolower_l(int c, locale_t loc);
DESCRIPTION
The tolower() function has as a domain of type int, the value of
which is representable as an unsigned char or the value of EOF. If
the argument has any other value, the argument is returned unchanged.
If the argument of tolower() represents an upper-case letter, and
there exists a corresponding lower-case letter (as defined by
character type information in the locale category LC_CTYPE), the
result is the corresponding lower-case letter. All other arguments in
the domain are returned unchanged.
The function tolower_l() behaves identically to tolower(), except
instead of operating in the current locale, it operates in the locale
specified by loc.
A macro form, _tolower() exists. It is defined for standards
conformance, particularly with legacy standards. It was deprecated in
POSIX 2008 (Issue 7), and its use is discouraged. The macro, on this
system, is just an alias for tolower().
RETURN VALUES
On successful completion, tolower() returns the lower-case letter
corresponding to the argument passed. Otherwise, it returns the
argument unchanged.
ERRORS
No errors are defined.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|CSI | Enabled |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
SEE ALSO
newlocale(3C), setlocale(3C), uselocale(3C), attributes(7),
standards(7)
October 4, 2015 TOLOWER(3C)