std::toupper(std::locale)

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

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

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

ローカライゼーションライブラリ

ロケールとファセット
locale
use_facet	has_facet
文字分類
isspace isblank (C++11) iscntrl isupper islower isalpha	isdigit ispunct isxdigit isalnum isprint isgraph
変換
toupper tolower	wstring_convert (C++11) wbuffer_convert (C++11)
ファセットカテゴリの基底クラス
ctype_base codecvt_base messages_base	time_base money_base
ファセットカテゴリ
ctype ctype<char> codecvt collate messages time_get time_put	num_get num_put numpunct money_get money_put moneypunct
ロケール固有のファセット
ctype_byname codecvt_byname messages_byname collate_byname	time_get_byname time_put_byname numpunct_byname moneypunct_byname
コード変換ファセット
codecvt_utf8 (C++11) codecvt_utf16 (C++11)	codecvt_utf8_utf16 (C++11) codecvt_mode (C++11)
Cのロケール
setlocale localeconv lconv	LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME

 

ヘッダ <locale> で定義
template<class charT > charT toupper( charT ch, const locale& loc );

可能であれば、指定されたロケールの std::ctype ファセットによって規定される変換ルールを使用して、文字 ch を大文字に変換します。

引数

ch	-	文字
loc	-	ロケール

戻り値

ロケールにリストされていれば、 ch の大文字形を返します。 そうでなければ、 ch を変更せずに返します。

ノート

1:1 の文字マッピングのみがこの関数によって行うことができます。 例えば、 'ß' の大文字形は (いくつかの例外はありますが) 2文字の文字列 "SS" であり、これは std::toupper によって取得することはできません。

実装例

template<class charT > charT toupper( charT ch, conststd::locale& loc ){returnstd::use_facet<std::ctype<charT>>(loc).toupper(ch);}

例

Run this code

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

出力:

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

関連項目

tolower(std::locale)	指定されたロケールの ctype ファセットを使用して文字を小文字に変換します (関数テンプレート)
toupper	文字を大文字に変換します (関数)
towupper	ワイド文字を大文字に変換します (関数)