std::toupper(std::locale)

template< class CharT >
CharT toupper( CharT ch, const locale& loc );

Преобразует символ ch в верхний регистр, если это возможно, используя правила преобразования, заданные компонентой std::ctype заданного локали.

Параметры

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

Возвращает форму символа ch в верхнем регистре, если она указана в локали, в противном случае возвращает ch без изменений.

Примечания

Данная функция может выполнить только 1:1 отображение символов, например, форма в верхнем регистре символа 'ß' (за некоторыми исключениями) является двухсимвольной строкой "SS", которую нельзя получить с помощью std::toupper.

Возможная реализация

template<class CharT>
CharT toupper(CharT ch, const std::locale& loc)
{
    return std::use_facet<std::ctype<CharT>>(loc).toupper(ch);
}

Пример

#include <cwctype>
#include <iostream>
#include <locale>
 
int main()
{
    wchar_t c = L'\u017f'; // Latin small letter Long S ('ſ')
 
    std::cout << std::hex << std::showbase;
 
    std::cout << "in the default locale, toupper(" << (std::wint_t)c << ") = "
              << (std::wint_t)std::toupper(c, std::locale()) << '\n';
 
    std::cout << "in Unicode locale, toupper(" << (std::wint_t)c << ") = "
              << (std::wint_t)std::toupper(c, std::locale("en_US.utf8")) << '\n';
}

in the default locale, toupper(0x17f) = 0x17f
in Unicode locale, toupper(0x17f) = 0x53

См. также