2000-02-17 20:39:52 +01:00
|
|
|
/*
|
|
|
|
FUNCTION
|
2016-08-15 14:21:52 +02:00
|
|
|
<<tolower>>, <<tolower_l>>---translate characters to lowercase
|
2000-02-17 20:39:52 +01:00
|
|
|
|
|
|
|
INDEX
|
|
|
|
tolower
|
2016-08-15 14:21:52 +02:00
|
|
|
|
|
|
|
INDEX
|
|
|
|
tolower_l
|
|
|
|
|
2000-02-17 20:39:52 +01:00
|
|
|
INDEX
|
|
|
|
_tolower
|
|
|
|
|
2017-11-30 08:17:11 +01:00
|
|
|
SYNOPSIS
|
2000-02-17 20:39:52 +01:00
|
|
|
#include <ctype.h>
|
|
|
|
int tolower(int <[c]>);
|
|
|
|
int _tolower(int <[c]>);
|
|
|
|
|
2016-08-15 14:21:52 +02:00
|
|
|
#include <ctype.h>
|
|
|
|
int tolower_l(int <[c]>, locale_t <[locale]>);
|
|
|
|
|
2000-02-17 20:39:52 +01:00
|
|
|
|
|
|
|
DESCRIPTION
|
2005-10-28 23:33:23 +02:00
|
|
|
<<tolower>> is a macro which converts uppercase characters to lowercase,
|
|
|
|
leaving all other characters unchanged. It is only defined when
|
2000-02-17 20:39:52 +01:00
|
|
|
<[c]> is an integer in the range <<EOF>> to <<255>>.
|
|
|
|
|
2016-08-15 14:21:52 +02:00
|
|
|
<<tolower_l>> is like <<tolower>> but performs the function based on the
|
|
|
|
locale specified by the locale object locale. If <[locale]> is
|
|
|
|
LC_GLOBAL_LOCALE or not a valid locale object, the behaviour is undefined.
|
|
|
|
|
2000-02-17 20:39:52 +01:00
|
|
|
You can use a compiled subroutine instead of the macro definition by
|
2016-08-15 14:21:52 +02:00
|
|
|
undefining this macro using `<<#undef tolower>>' or `<<#undef tolower_l>>'.
|
2000-02-17 20:39:52 +01:00
|
|
|
|
|
|
|
<<_tolower>> performs the same conversion as <<tolower>>, but should
|
|
|
|
only be used when <[c]> is known to be an uppercase character (<<A>>--<<Z>>).
|
|
|
|
|
|
|
|
RETURNS
|
2016-08-15 14:21:52 +02:00
|
|
|
<<tolower>>, <<tolower_l>> return the lowercase equivalent of <[c]> when
|
|
|
|
<[c]> is an uppercase character, and <[c]> otherwise.
|
2000-02-17 20:39:52 +01:00
|
|
|
|
2005-10-28 23:33:23 +02:00
|
|
|
<<_tolower>> returns the lowercase equivalent of <[c]> when it is a
|
2000-02-17 20:39:52 +01:00
|
|
|
character between <<A>> and <<Z>>. If <[c]> is not one of these
|
|
|
|
characters, the behaviour of <<_tolower>> is undefined.
|
|
|
|
|
|
|
|
PORTABILITY
|
2016-08-15 14:21:52 +02:00
|
|
|
<<tolower>> is ANSI C. <<_tolower>> is not recommended for portable programs.
|
|
|
|
<<tolower_l>> is POSIX-1.2008.
|
2000-02-17 20:39:52 +01:00
|
|
|
|
|
|
|
No supporting OS subroutines are required.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <_ansi.h>
|
|
|
|
#include <ctype.h>
|
2009-03-31 11:31:38 +02:00
|
|
|
#if defined (_MB_EXTENDED_CHARSETS_ISO) || defined (_MB_EXTENDED_CHARSETS_WINDOWS)
|
|
|
|
#include <limits.h>
|
|
|
|
#include <stdio.h>
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <wctype.h>
|
|
|
|
#include <wchar.h>
|
|
|
|
#endif
|
2000-02-17 20:39:52 +01:00
|
|
|
|
|
|
|
#undef tolower
|
|
|
|
int
|
2017-12-04 04:43:30 +01:00
|
|
|
tolower (int c)
|
2000-02-17 20:39:52 +01:00
|
|
|
{
|
2009-03-31 11:31:38 +02:00
|
|
|
#if defined (_MB_EXTENDED_CHARSETS_ISO) || defined (_MB_EXTENDED_CHARSETS_WINDOWS)
|
|
|
|
if ((unsigned char) c <= 0x7f)
|
|
|
|
return isupper (c) ? c - 'A' + 'a' : c;
|
|
|
|
else if (c != EOF && MB_CUR_MAX == 1 && isupper (c))
|
|
|
|
{
|
|
|
|
char s[MB_LEN_MAX] = { c, '\0' };
|
|
|
|
wchar_t wc;
|
|
|
|
if (mbtowc (&wc, s, 1) >= 0
|
|
|
|
&& wctomb (s, (wchar_t) towlower ((wint_t) wc)) == 1)
|
2009-06-09 13:33:57 +02:00
|
|
|
c = (unsigned char) s[0];
|
2009-03-31 11:31:38 +02:00
|
|
|
}
|
|
|
|
return c;
|
|
|
|
#else
|
|
|
|
return isupper(c) ? (c) - 'A' + 'a' : c;
|
|
|
|
#endif
|
2000-02-17 20:39:52 +01:00
|
|
|
}
|