std::towupper

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (C++11)

フォーマットライブラリ (C++20)

ヌル終端シーケンスユーティリティ

バイト文字列

マルチバイト文字列

ワイド文字列

プリミティブな数値変換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

テキストエンコーディング識別

text_encoding (C++26)

 

ヌル終端ワイド文字列

関数
文字の分類
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit wctype	iswblank (C++11) iswctype iswcntrl iswgraph iswspace iswprint iswpunct
文字操作
towlower towupper	towctrans wctrans
数値フォーマットへの変換
wcstolwcstoll (C++11)   wcstofwcstodwcstold (C++11)(C++11)	wcstoulwcstoull (C++11) wcstoimaxwcstouimax (C++11)(C++11)
文字列操作
wcslen wcscmp wcscoll wcsncmp wcschr wcsrchr	wcspbrk wcsspn wcscspn wcsstr wcstok
文字列検査
wcscpy wcsncpy wcsxfrm	wcscat wcsncat
配列操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset
型 wctrans_t wctype_t wint_t	マクロ WCHAR_MIN WCHAR_MAX WEOF

 

ヘッダ <cwctype> で定義
std::wint_t towupper( std::wint_t ch );

指定されたワイド文字を、可能な場合は大文字に変換します。

ch の値が wchar_t として表現可能でもなく、マクロ WEOF の値と等しくもない場合、動作は未定義です。

パラメータ

文字

-

変換するワイド文字

戻り値

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

注釈

この関数では、1 対 1 の文字マッピングのみが実行可能です。例えば、'ß' の大文字形式は（いくつかの例外を除き）2 文字の文字列 "SS" ですが、これは std::towupper では取得できません。

ISO 30112 は、Unicode 文字のどのペアがこのマッピングに含まれるかを規定しています。

例

ラテン文字の 「ſ」 (U+017F) は、「S」 (U+0053) の代替小文字形式です。

このコードを実行

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

出力

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

関連項目

towlower	ワイド文字を小文字に変換する (関数)
toupper(std::locale)	ロケールのctypeファセットを使用して文字を大文字に変換する (関数テンプレート)
toupper	文字を大文字に変換する (関数)
C ドキュメント (towupper)