GNU
2017-09-15
Aliases: tolower(3), tolower(3), tolower(3), tolower(3), tolower(3), tolower(3), tolower(3), tolower(3), tolower(3), tolower(3), tolower(3), tolower(3), tolower_l(3), tolower_l(3), tolower_l(3), tolower_l(3), tolower_l(3), tolower_l(3), tolower_l(3), tolower_l(3), tolower_l(3), tolower_l(3), toupper_l(3), toupper_l(3), toupper_l(3), toupper_l(3), toupper_l(3), toupper_l(3), toupper_l(3), toupper_l(3), toupper_l(3), toupper_l(3)
man-pages-ru
Russian man pages from the Linux Documentation Project
manpages-dev
Manual pages about using GNU/Linux for development
man-pages
Linux kernel and C library user-space interface documentation
ИМЯ
toupper, tolower, toupper_l, tolower_l - преобразуют регистр символов
ОБЗОР
#include <ctype.h>
int toupper(int c); int tolower(int c);
int toupper_l(int c, locale_t locale); int tolower_l(int c, locale_t locale);
Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):
toupper_l(), tolower_l():
| Начиная с glibc 2.10: | |
| _XOPEN_SOURCE >= 700 | |
| До glibc 2.10: | |
| _GNU_SOURCE | |
ОПИСАНИЕ
Эти функции преобразуют строчные символы в заглавные и наоборот.
Если c — строчная буква, то toupper() возвращает её заглавный эквивалент, если он есть в текущей локали. В противном случае возвращается c. Функция toupper_l() выполняет ту же задачу, но использует локаль, на которую ссылается описатель локали locale.
Если c — заглавная буква, то tolower() возвращает её строчный эквивалент, если он есть в текущей локали. В противном случае возвращается c. Функция tolower_l() выполняет ту же задачу, но использует локаль, на которую ссылается описатель локали locale.
Если c имеет значение не типа unsigned char или не равно EOF, то поведение этих функций не определено.
Поведение toupper_l() и tolower_l() не определено, если значение locale равно специальному объекту локали LC_GLOBAL_LOCALE (смотрите duplocale(3)) или некорректному описателю объекта локали.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Возвращаемым значением является преобразованная буква или c, если преобразование невозможно.
АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
| Интерфейс | Атрибут | Значение |
| toupper(), tolower(), toupper_l(), tolower_l() |
Безвредность в нитях | MT-Safe |
СООТВЕТСТВИЕ СТАНДАРТАМ
toupper(), tolower(): C89, C99, 4.3BSD, POSIX.1-2001, POSIX.1-2008.
toupper_l(), tolower_l(): POSIX.1-2008.
ЗАМЕЧАНИЯ
Стандартами требуется, что аргумент c этих функций равнялся EOF или значению, которое представимо типом unsigned char. Если аргумент c имеет тип char, то он должен приводиться к unsigned char как в следующем примере:
char c; ... res = toupper((unsigned char) c);
Это необходимо, так как char может быть эквивалентен signed char, и если у байта установлен старший знаковый бит, то он учитывается при приведении к int и байт превращается в значение, выходящее за границу unsigned char.
Особенности подстановки строчных и прописных букв зависят от локали. Например, в локали по умолчанию "C" ничего не сказано про умляуты, поэтому они не преобразовываются.
В некоторых не английских локалях существуют строчные буквы без заглавного аналога; например немецкая sharp.
