tolower, _tolower, towlower, _tolower_l, _towlower_l

Преобразует символ в строчный.

Синтаксис

int tolower(
   int c
);
int _tolower(
   int c
);
int towlower(
   wint_t c
);
int _tolower_l(
   int c,
   _locale_t locale
);
int _towlower_l(
   wint_t c,
   _locale_t locale
);

Параметры

c
Символ для преобразования.

locale
Языковой стандарт для перевода в определенном языковом стандарте.

Возвращаемое значение

Каждая из этих подпрограмм преобразует копию c в строчный символ, если это преобразование возможно, и возвращает результат. Возвращаемое значение не зарезервировано для указания ошибки.

Замечания

Каждая из этих подпрограмм преобразует заданную прописную букву в строчную букву, если это возможно и уместно. Преобразование регистра towlower зависит от языкового стандарта. Изменяются только символы, соответствующие текущему языковому стандарту. Функции без суффикса _l используют текущий языковой стандарт. Версии этих функций, имеющие суффикс _l, идентичны функциям без суффикса, за исключением того, что они принимают языковой стандарт в качестве параметра и используют его вместо текущего языкового стандарта. Дополнительные сведения см. в разделе Locale.

Чтобы _tolower дать ожидаемые результаты, __isascii и isupper оба должны возвращать ненулевое значение.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

Подпрограмма TCHAR.H	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_totlower	tolower	_mbctolower	towlower
_totlower_l	_tolower_l	_mbctolower_l	_towlower_l

Примечание.

Функции _tolower_l и _towlower_l не зависят от языкового стандарта и не предназначены для непосредственного вызова. Они предназначены для внутреннего использования _totlower_l.

Требования

Маршрут	Обязательный заголовок
tolower	<ctype.h>
_tolower	<ctype.h>
towlower	<ctype.h> или <wchar.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

См. пример в to функциях.

См. также

Преобразование данных
is, isw подпрограммы
Функции to
Локаль
Интерпретация последовательностей многобайтовых символов