База знанияИзпитен център
BGБългарски
Избери език13

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!

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници