_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

文字列を小文字に変換します。 これらの関数のセキュリティを強化したバージョンを使用できます。「_strlwr_s、_strlwr_s_l、_mbslwr_s、_mbslwr_s_l、_wcslwr_s、_wcslwr_s_l」を参照してください。

重要

_mbslwr および _mbslwr_l は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。

構文

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

パラメーター

str
小文字に変換する、NULL で終わる文字列。

locale
使用するロケール。

戻り値

これらの各関数は、変換された文字列へのポインターを返します。 同じ位置で変更が実行されるため、返されるポインターは入力引数として渡されるポインターと同じです。 エラーを示す戻り値は予約されていません。

解説

_strlwr 関数は、str 内の大文字をロケールの LC_CTYPE カテゴリの設定によって決定される小文字に変換します。 その他の文字は影響を受けません。 LC_CTYPE の詳細については、「setlocale」を参照してください。 サフィックスのない _l これらの関数のバージョンでは、ロケールに依存する動作に現在のロケールが使用されます。サフィックスを持つ _l バージョンは、代わりに渡されたロケールを使用する点を除いて同じです。 詳細については、「 Locale」を参照してください。

_wcslwr 関数と _mbslwr 関数は、_strlwr 関数のワイド文字バージョンとマルチバイト文字バージョンです。 引数と戻り値 _wcslwr はワイド文字列です。 引数と戻り値 _mbslwr はマルチバイト文字列です。 それ以外では、これらの関数の動作は同じです。

ポインターのNULL場合str、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、これらの関数は errno を EINVAL に設定し、元の文字列を返します。

C++ では、これらの関数にテンプレートのオーバーロードがあります。このオーバーロードは、これらの関数に対応するセキュリティで保護された新しい関数を呼び出します。 詳細については、「セキュリティで保護されたテンプレート オーバーロード」を参照してください。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

汎用テキスト ルーチンのマップ

TCHAR.H のルーチン	_UNICODE と _MBCS が定義されていない	_MBCS が定義されている	_UNICODE が定義されている
_tcslwr	_strlwr	_mbslwr	_wcslwr
_tcslwr_l	_strlwr_l	_mbslwr_l	_wcslwr_l

必要条件

ルーチンによって返される値	必須ヘッダー
_strlwr, _strlwr_l	<string.h>
_wcslwr, _wcslwr_l	<string.h> または <wchar.h>
_mbslwr, _mbslwr_l	<mbstring.h>

互換性の詳細については、「 Compatibility」を参照してください。

例

// 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!

関連項目

文字列操作
ロケール
_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr