_strupr、_strupr_l、_mbsupr、_mbsupr_l、_wcsupr_l、_wcsupr_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

文字列を大文字に変換します。Converts a string to uppercase. これらの関数にはセキュリティが強化されたバージョンがあります。「_strupr_s、_strupr_s_l、_mbsupr_s、_mbsupr_s_l、_wcsupr_s、_wcsupr_s_l」をご覧ください。More secure versions of these functions are available; see _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.

重要

_mbsupr_mbsupr_l Windows ランタイムで実行するアプリケーションでは使用できません。_mbsupr and _mbsupr_l cannot be used in applications that execute in the Windows Runtime. 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。For more information, see CRT functions not supported in Universal Windows Platform apps.

構文Syntax

char *_strupr(
   char *str
);
wchar_t *_wcsupr(
   wchar_t *str
);
unsigned char *_mbsupr(
   unsigned char *str
);
char *_strupr_l(
   char *str,
   _locale_t locale
);
wchar_t *_wcsupr_l(
   wchar_t *str,
   _locale_t locale
);
unsigned char *_mbsupr_l(
   unsigned char *str,
   _locale_t locale
);
template <size_t size>
char *_strupr(
   char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcsupr(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbsupr(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strupr_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcsupr_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbsupr_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

パラメーターParameters

strstr
大文字にする文字列。String to capitalize.

localelocale
使用するロケール。The locale to use.

戻り値Return Value

変更された文字列へのポインターを返します。Returns a pointer to the altered string. 同じ位置で変更が実行されるため、返されるポインターは入力引数として渡されるポインターと同じです。Because the modification is done in place, the pointer returned is the same as the pointer passed as the input argument. エラーを示す戻り値は予約されていません。No return value is reserved to indicate an error.

RemarksRemarks

_Struprインプレースでの小文字の変換関数strを大文字にします。The _strupr function converts, in place, each lowercase letter in str to uppercase. 変換がによって決定されます、 LC_CTYPEロケールのカテゴリの設定。The conversion is determined by the LC_CTYPE category setting of the locale. 他の文字は影響を受けません。Other characters are not affected. 詳細についてはLC_CTYPEを参照してくださいsetlocaleします。For more information on LC_CTYPE, see setlocale. この関数のバージョン、 _lサフィックスを使用しているバージョンは、現在のロケール、 _l代わりに渡されたロケールを使用する点を除いて、サフィックスは同じです。The versions of these functions without the _l suffix use the current locale; the versions with the _l suffix are identical except that they use the locale passed in instead. 詳細については、「 Locale」を参照してください。For more information, see Locale.

_wcsupr_mbsuprのワイド文字とマルチバイト文字バージョン _struprします。_wcsupr and _mbsupr are wide-character and multibyte-character versions of _strupr. 引数と戻り値 _wcsuprはワイド文字列 _mbsuprはマルチバイト文字の文字列。The argument and return value of _wcsupr are wide-character strings; those of _mbsupr are multibyte-character strings. それ以外では、これらの関数の動作は同じです。These three functions behave identically otherwise.

場合str null ポインターの場合で説明されているとおり、無効なパラメーター ハンドラーが呼び出されますパラメーターの検証です。If str is a null pointer, the invalid parameter handler is invoked, as described in Parameter Validation . 実行が続行すると、これらの関数の戻り値、元の文字列とセットを許可された場合errnoEINVALします。If execution is allowed to continue, these functions return the original string and set errno to EINVAL.

C++ では、これらの関数にテンプレートのオーバーロードがあります。このオーバーロードは、これらの関数に対応するセキュリティで保護された新しい関数を呼び出します。In C++, these functions have template overloads that invoke the newer, secure counterparts of these functions. 詳細については、「 Secure Template Overloads」を参照してください。For more information, see Secure Template Overloads.

汎用テキスト ルーチンのマップGeneric-Text Routine Mappings

TCHAR.H のルーチンTCHAR.H routine _UNICODE および _MBCS が未定義の場合_UNICODE & _MBCS not defined _MBCS が定義されている場合_MBCS defined _UNICODE が定義されている場合_UNICODE defined
_tcsupr_tcsupr _strupr_strupr _mbsupr_mbsupr _wcsupr_wcsupr
_tcsupr_l_tcsupr_l _strupr_l_strupr_l _mbsupr_l_mbsupr_l _wcsupr_l_wcsupr_l

必要条件Requirements

ルーチンによって返される値Routine 必須ヘッダーRequired header
_strupr_strupr_l_strupr, _strupr_l <string.h><string.h>
_wcsupr_wcsupr_l_wcsupr, _wcsupr_l <string.h> または <wchar.h><string.h> or <wchar.h>
_mbsupr_mbsupr_l_mbsupr, _mbsupr_l <mbstring.h><mbstring.h>

互換性の詳細については、「 互換性」を参照してください。For additional compatibility information, see Compatibility.

Example

_strlwr に関する記事の例をご覧ください。See the example for _strlwr.

関連項目See also

ロケールLocale
文字列操作String Manipulation
_strlwr、_wcslwr、_mbslwr、_strlwr_l、_wcslwr_l、_mbslwr_l_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l