Spec-Zone.ru › C

toupper

Определено в заголовке <ctype.h>
int toupper( int ch );

Преобразует заданный символ в верхний регистр в соответствии с правилами преобразования символов, определёнными текущим языковым окружением (C locale).

В стандартном языковом окружении "C" следующие строчные буквы abcdefghijklmnopqrstuvwxyz заменяются соответствующими прописными буквами ABCDEFGHIJKLMNOPQRSTUVWXYZ.

Параметры

ch - символ для преобразования. Если значение ch не может быть представлено как unsigned char и не равно EOF, поведение не определено.

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

Версия символа в верхнем регистре ch или неизменённый символ ch, если версия в верхнем регистре отсутствует в текущем языковом окружении (C locale).

Пример

#include <stdio.h>
#include <ctype.h>
#include <locale.h>
#include <limits.h>
 
int main(void)
{
    /* In the default locale: */
    for (unsigned char l = 0; l < UCHAR_MAX; l++) {
        unsigned char u = toupper(l);
        if (u != l) printf("%c%c ", l, u);
    }
    printf("\n\n");
 
    unsigned char c = '\xb8'; // the character Ž in ISO-8859-15
                              // but ´ (acute accent) in ISO-8859-1 
    setlocale(LC_ALL, "en_US.iso88591");
    printf("in iso8859-1, toupper('0x%x') gives 0x%x\n", c, toupper(c));
    setlocale(LC_ALL, "en_US.iso885915");
    printf("in iso8859-15, toupper('0x%x') gives 0x%x\n", c, toupper(c));
}

Возможный вывод:

aA bB cC dD eE fF gG hH iI jJ kK lL mM nN oO pP qQ rR sS tT uU vV wW xX yY zZ 
 
in iso8859-1, toupper('0xb8') gives 0xb8
in iso8859-15, toupper('0xb8') gives 0xb4

Ссылки

  • Стандарт C17 (ISO/IEC 9899:2018):
    • 7.4.2.2 Функция toupper (с. 147-148)
  • Стандарт C11 (ISO/IEC 9899:2011):
    • 7.4.2.2 Функция toupper (с. 204)
  • Стандарт C99 (ISO/IEC 9899:1999):
    • 7.4.2.2 Функция toupper (с. 185)
  • Стандарт C89/C90 (ISO/IEC 9899:1990):
    • 4.3.2.2 Функция toupper

См. также

tolower
преобразует символ в нижний регистр
(функция)
towupper
(C95)
преобразует широкий символ в верхний регистр
(функция)
Документация C++ для toupper

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/string/byte/toupper

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API