std::tolower
Определён в заголовке <cctype> | ||
|---|---|---|
int tolower( int ch ); |
Преобразует заданный символ в нижний регистр согласно правилам преобразования символов, определённым для текущей локали C.
В локали "C" по умолчанию следующие буквы верхнего регистра ABCDEFGHIJKLMNOPQRSTUVWXYZ заменяются соответствующими буквами нижнего регистра abcdefghijklmnopqrstuvwxyz.
Параметры
| ch | - | символ для преобразования. Если значение ch не представимо как unsignedchar и не равно EOF, поведение не определено |
Возвращаемое значение
Версия ch в нижнем регистре или неизменённое значение ch, если в текущей локали C не указана версия в нижнем регистре.
Примечания
Как и для всех остальных функций из <cctype>, поведение std::tolower не определено, если значение аргумента не представимо как unsignedchar и не равно EOF. Чтобы безопасно использовать эти функции с обычными символами char (или signedchar), аргумент сначала следует преобразовать к типу unsignedchar:
char my_tolower(char ch)
{
return static_cast<char>(std::tolower(static_cast<unsigned char>(ch)));
}
Аналогично, их не следует напрямую использовать со стандартными алгоритмами, если тип значения итератора — char или signedchar. Вместо этого сначала преобразуйте значение к типу unsignedchar:
std::string str_tolower(std::string s)
{
std::transform(s.begin(), s.end(), s.begin(),
// static_cast<int(*)(int)>(std::tolower) // wrong
// [](int c){ return std::tolower(c); } // wrong
// [](char c){ return std::tolower(c); } // wrong
[](unsigned char c){ return std::tolower(c); } // correct
);
return s;
}
Пример
#include <cctype>
#include <clocale>
#include <iostream>
int main()
{
unsigned char c = '\xb4'; // the character Ž in ISO-8859-15
// but ´ (acute accent) in ISO-8859-1
std::setlocale(LC_ALL, "en_US.iso88591");
std::cout << std::hex << std::showbase;
std::cout << "in iso8859-1, tolower('0xb4') gives " << std::tolower(c) << '\n';
std::setlocale(LC_ALL, "en_US.iso885915");
std::cout << "in iso8859-15, tolower('0xb4') gives " << std::tolower(c) << '\n';
}
Возможный вывод:
in iso8859-1, tolower('0xb4') gives 0xb4
in iso8859-15, tolower('0xb4') gives 0xb8
См. также
| преобразует символ в верхний регистр (функция) |
|
преобразует символ в нижний регистр с использованием фасета ctype локали (шаблон функции) |
|
| преобразует широкий символ в нижний регистр (функция) |
|
Документация по C для tolower |
|
Внешние ссылки
| 1. | ISO/IEC 8859-1. Из Википедии. |
| 2. | ISO/IEC 8859-15. Из Википедии. |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/string/byte/tolower