toupper

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

文字列ライブラリ

ヌル終端バイト文字列

ヌル終端マルチバイト文字列

ヌル終端ワイド文字列

 

ヌル終端バイト文字列

関数
文字操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
数値フォーマットとの変換
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
文字列操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
文字列検査
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
メモリ操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
その他
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

ヘッダ <ctype.h> で定義
int toupper( int ch );

現在インストールされているCロケールで定義されている文字変換規則に従って、指定された文字を大文字に変換します。

デフォルトの "C" ロケールでは、次の小文字 abcdefghijklmnopqrstuvwxyz は、それぞれ対応する大文字 ABCDEFGHIJKLMNOPQRSTUVWXYZ に置き換えられます。

パラメータ

文字

-

変換される文字。 ch の値が unsigned char として表現できず、かつ EOF と等しくない場合、動作は未定義です。

戻り値

ch の大文字バージョン、または現在のCロケールで大文字バージョンがリストされていない場合は、変更されない ch。

例

このコードを実行

#include <ctype.h>
#include <limits.h>
#include <locale.h>
#include <stdio.h>
 
int main(void)
{
    // in the default locale:
    for (unsigned char l = 0, u; l != UCHAR_MAX; ++l)
        if ((u = toupper(l)) != l)
            printf("%c%c ", l, u);
    printf("\n\n");
 
    unsigned char c = '\xb8'; // the character ž in ISO-8859-15
                              // but ¸ (cedilla) 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

参考文献

• C23標準 (ISO/IEC 9899:2024)

• 7.4.2.2 toupper関数 (p: TBD)

• C17標準 (ISO/IEC 9899:2018)

• 7.4.2.2 toupper関数 (p: 147-148)

• C11標準 (ISO/IEC 9899:2011)

• 7.4.2.2 toupper関数 (p: 204)

• C99標準 (ISO/IEC 9899:1999)

• 7.4.2.2 toupper関数 (p: 185)

• C89/C90標準 (ISO/IEC 9899:1990)

• 4.3.2.2 toupper関数

関連項目

tolower	文字を小文字に変換する (関数)
towupper (C95)	ワイド文字を大文字に変換する (関数)
C++ ドキュメント (toupper)