_strlwr、_wcslwr、_mbslwr、_strlwr_l、_wcslwr_l、_mbslwr_l_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

文字列を小文字に変換します。Converts a string to lowercase. これらの関数にはセキュリティが強化されたバージョンがあります。「_strlwr_s、_strlwr_s_l、_mbslwr_s、_mbslwr_s_l、_wcslwr_s、_wcslwr_s_l」を参照してください。More secure versions of these functions are available; see _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l.

重要

_mbslwr_mbslwr_l Windows ランタイムで実行するアプリケーションでは使用できません。_mbslwr and _mbslwr_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 *_strlwr(
   char * str
);
wchar_t *_wcslwr(
   wchar_t * str
);
unsigned char *_mbslwr(
   unsigned char * str
);
char *_strlwr_l(
   char * str,
   _locale_t locale
);
wchar_t *_wcslwr_l(
   wchar_t * str,
   _locale_t locale
);
unsigned char *_mbslwr_l(
   unsigned char * str,
   _locale_t locale
);
template <size_t size>
char *_strlwr(
   char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcslwr(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbslwr(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strlwr_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcslwr_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbslwr_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

パラメーターParameters

strstr
小文字に変換する、NULL で終わる文字列。Null-terminated string to convert to lowercase.

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

戻り値Return Value

これらの各関数は、変換された文字列へのポインターを返します。Each of these functions returns a pointer to the converted 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

_Strlwr関数が内の大文字に変換しますstrによって決定される小文字にする、 LC_CTYPEロケールのカテゴリの設定。The _strlwr function converts any uppercase letters in str to lowercase as 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 for their locale-dependent behavior; the versions with the _l suffix are identical except that they use the locale passed in instead. 詳細については、「 Locale」を参照してください。For more information, see Locale.

_Wcslwr_mbslwr関数のワイド文字とマルチバイト文字バージョンは、 _strlwrします。The _wcslwr and _mbslwr functions are wide-character and multibyte-character versions of _strlwr. 引数と戻り値 _wcslwrはワイド文字列 _mbslwrはマルチバイト文字の文字列。The argument and return value of _wcslwr are wide-character strings; those of _mbslwr 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
_tcslwr_tcslwr _strlwr_strlwr _mbslwr_mbslwr _wcslwr_wcslwr
_tcslwr_l_tcslwr_l _strlwr_l_strlwr_l _mbslwr_l_mbslwr_l _wcslwr_l_wcslwr_l

必要条件Requirements

ルーチンによって返される値Routine 必須ヘッダーRequired header
_strlwr_strlwr_l_strlwr, _strlwr_l <string.h><string.h>
_wcslwr_wcslwr_l_wcslwr, _wcslwr_l <string.h> または <wchar.h><string.h> or <wchar.h>
_mbslwr_mbslwr_l_mbslwr, _mbslwr_l <mbstring.h><mbstring.h>

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

Example

// crt_strlwr.c
// compile with: /W3
// This program uses _strlwr and _strupr to create
// uppercase and lowercase copies of a mixed-case string.
#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[100] = "The String to End All Strings!";
   char * copy1 = _strdup( string ); // make two copies
   char * copy2 = _strdup( string );

   _strlwr( copy1 ); // C4996
   // Note: _strlwr is deprecated; consider using _strlwr_s instead
   _strupr( copy2 ); // C4996
   // Note: _strupr is deprecated; consider using _strupr_s instead

   printf( "Mixed: %s\n", string );
   printf( "Lower: %s\n", copy1 );
   printf( "Upper: %s\n", copy2 );

   free( copy1 );
   free( copy2 );
}
Mixed: The String to End All Strings!
Lower: the string to end all strings!
Upper: THE STRING TO END ALL STRINGS!

関連項目See also

文字列操作String Manipulation
ロケールLocale
_strupr、_strupr_l、_mbsupr、_mbsupr_l、_wcsupr_l、_wcsupr_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr