_strupr_s、_strupr_s_l、_mbsupr_s、_mbsupr_s_l、_wcsupr_s、_wcsupr_s_l
渡された現在のロケールまたは指定されたロケールを使用して、文字列を大文字に変換します。これらの関数は、「CRT のセキュリティ機能」に説明されているように、_strupr、_strupr_l、_mbsupr、_mbsupr_l、_wcsupr_l、_wcsupr のセキュリティが強化されたバージョンです。
重要 |
---|
_mbsupr_s と _mbsupr_s_l は、Windows のランタイムで実行するアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。 |
errno_t _strupr_s(
char *str,
size_t numberOfElements
);
errno_t _wcsupr_s(
wchar_t * str,
size_t numberOfElements
);
errno_t _strupr_s_l(
char * str,
size_t numberOfElements,
_locale_t locale
);
errno_t _wcsupr_s_l(
wchar_t * str,
size_t numberOfElements,
_locale_t locale
);
errno_t _mbsupr_s(
unsigned char *str,
size_t numberOfElements
);
errno_t _mbsupr_s_l(
unsigned char *str,
size_t numberOfElements,
_locale_t locale
);
template <size_t size>
errno_t _strupr_s(
char (&str)[size]
); // C++ only
template <size_t size>
errno_t _wcsupr_s(
wchar_t (&str)[size]
); // C++ only
template <size_t size>
errno_t _strupr_s_l(
char (&str)[size],
_locale_t locale
); // C++ only
template <size_t size>
errno_t _wcsupr_s_l(
wchar_t (&str)[size],
_locale_t locale
); // C++ only
template <size_t size>
errno_t _mbsupr_s(
unsigned char (&str)[size]
); // C++ only
template <size_t size>
errno_t _mbsupr_s_l(
unsigned char (&str)[size],
_locale_t locale
); // C++ only
パラメーター
str
大文字にする文字列。numberOfElements
バッファーのサイズ。locale
使用するロケール。
戻り値
正常終了した場合は 0 を返します。失敗した場合は 0 以外のエラー コードを返します。
これらの関数では、パラメーターの検証が行われます。str が NULL のポインターである場合、無効なパラメーター ハンドラーが パラメーターの検証 に説明されているように、開始されます。実行の継続が許可された場合、関数は EINVAL を返し、errno を EINVAL に設定します。numberOfElements が ERANGE文字列、関数の戻り値 ERANGE と同様に errno の長さよりも小さい場合。
解説
_strupr_s の関数は、str のそれぞれの大文字小文字に変換します。_wcsupr_s 関数は、_strupr_s 関数のワイド文字バージョンです。_mbsupr_s は _strupr_sのマルチバイト文字のバージョンです。
変換は LC_CTYPE のロケールのカテゴリの設定によって決まります。他の文字は影響を受けません。LC_CTYPE の詳細については、「setlocale、_wsetlocale」を参照してください。_l のサフィックスを使用しないこれらの関数の各バージョンは、現在のロケールを使用します; _l のサフィックスにビジョンは同じですが、代わりに渡されたロケールを使用します。詳細については、「ロケール」を参照してください。
C++ では、これらの関数の使用はテンプレートのオーバーロードによって簡素化されます。オーバーロードでは、バッファー長を自動的に推論できる (サイズの引数を指定する必要がなくなる) だけでなく、古くてセキュリティが万全ではない関数を新しく安全な関数に自動的に置き換えることができます。詳細については、「セキュリティ保護されたテンプレート オーバーロード」を参照してください。
これらの関数のデバッグ バージョンは、最初にバッファーを 0xFD で埋めます。この動作を無効にするには、_CrtSetDebugFillThreshold を使用します。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_tcsupr_s |
_strupr_s |
_mbsupr_s |
_wcsupr_s |
_tcsupr_s_l |
_strupr_s_l |
_mbsupr_s_l |
_wcsupr_s_l |
必要条件
ルーチン |
必須ヘッダー |
---|---|
_strupr_s, _strupr_s_l |
<string.h> |
_wcsupr_s, _wcsupr_s_l, _mbsupr_s, _mbsupr_s_l |
<string.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
_strlwr_s、_strlwr_s_l、_mbslwr_s、_mbslwr_s_l、_wcslwr_s、_wcslwr_s_l の例を参照してください。
同等の .NET Framework 関数
参照
関連項目
_strlwr_s、_strlwr_s_l、_mbslwr_s、_mbslwr_s_l、_wcslwr_s、_wcslwr_s_l