CKTIS / C++
std::toupper — преобразуване на един знак в главна буква
std::toupper от <cctype> връща съответната главна буква според текущата C локализация. Аргументът трябва да е равен на EOF или да може да се представи като unsigned char; типът на връщаната стойност е int.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <cctype>
int std::toupper(int c);std::toupper от <cctype> има сигнатура int std::toupper(int c). Функцията връща съответната главна буква според текущата C локализация или непроменения аргумент, ако преобразуване не е възможно. Тя не променя аргумента: присвоете резултата или го използвайте по друг начин.
Стойността, подадена на параметъра от тип int, трябва да е равна на EOF или да може да се представи като unsigned char. Всяка друга стойност води до недефинирано поведение. Тъй като обикновеният char може да е отрицателен, за променлива от тип char използвайте std::toupper(static_cast<unsigned char>(ch)), при условие че стойността след явното преобразуване е представима като int. Ако int не може да представи всички стойности на unsigned char, преди извикването проверете дали получената стойност е в диапазона на int. В противен случай преобразуването към int може да даде отрицателна стойност, различна от EOF, и да доведе до недефинирано поведение. Ако преобразуването даде EOF, функцията получава EOF вместо стойността на знака. Ако входна функция върне стойност от тип int, проверете дали тя е равна на EOF, преди да я преобразувате в unsigned char.
Примерът обработва низ знак по знак и изрично преобразува резултата от тип int обратно в char. Той предполага, че всяка стойност, получена чрез преобразуване към unsigned char, е представима като int. При началната локализация "C" очакваният изход е HELLO, C++23!, последван от знак за нов ред. Това не е общ механизъм за преобразуване на регистъра в Unicode: обработката на UTF-8 байтове по този начин не е достатъчна.
Не бъркайте тази функция с претоварването std::toupper(c, loc) от <locale>, което използва изрично подаден обект за локализация. Указанията по-горе за преобразуване към unsigned char важат за функцията с един аргумент от <cctype>.
Примери
#include <cctype>
#include <iostream>
#include <string>
int main() {
std::string text = "Hello, C++23!";
for (char& ch : text) {
ch = static_cast<char>(
std::toupper(static_cast<unsigned char>(ch)));
}
std::cout << text << '\n';
}
Резултат
HELLO, C++23!
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.