_strset、 _strset_l、 _wcsset、 _wcsset_l、 _mbsset、 _mbsset_l

文字列の文字をある文字に設定します。 これらの関数のセキュリティを強化したバージョンを使用できます。「_strset_s、_strset_s_l、_wcsset_s、_wcsset_s_l、_mbsset_s、_mbsset_s_l」を参照してください。

構文

char *_strset(
   char *str,
   int c
);
char *_strset_l(
   char *str,
   int c,
   _locale_t locale
);
wchar_t *_wcsset(
   wchar_t *str,
   wchar_t c
);
wchar_t *_wcsset_l(
   wchar_t *str,
   wchar_t c,
   _locale_t locale
);
unsigned char *_mbsset(
   unsigned char *str,
   unsigned int c
);
unsigned char *_mbsset_l(
   unsigned char *str,
   unsigned int c,
   _locale_t locale
);

パラメーター

str
NULL で終わる、設定される文字列。

c
文字設定。

locale
使用するロケール。

戻り値

変更された文字列へのポインターを返します。

解説

_strset 関数は str のすべての文字 (終端の NULL 文字を除く) を c に変換された char に設定します。 _wcsset と _mbsset_l は _strset のワイド文字バージョンとマルチバイト文字バージョンであり、それに応じて引数と戻り値のデータ型が異なります。 それ以外では、これらの関数の動作は同じです。

_mbsset はそのパラメーターを検証します。 str が null ポインターである場合は、「パラメーターの検証」で説明されているとおり、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、_mbsset は NULL を返し、errno を EINVAL に設定します。 _strset と _wcsset はパラメーターを検証しません。

出力値は、ロケールの LC_CTYPE カテゴリ設定の設定によって影響を受けます。 詳細については、setlocaleを参照してください。 _l サフィックスが付いていないバージョンが現在のロケールを使用し、_l サフィックスが付いているバージョンが渡されたロケール パラメーターを代わりに使用する点を除いて、これらの関数のバージョンは同じです。 詳細については、「 Locale」を参照してください。

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

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

要件

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

例

// crt_strset.c
// compile with: /W3

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[] = "Fill the string with something.";
   printf( "Before: %s\n", string );
   _strset( string, '*' ); // C4996
   // Note: _strset is deprecated; consider using _strset_s instead
   printf( "After:  %s\n", string );
}

Before: Fill the string with something.
After:  *******************************

関連項目

文字列操作
ロケール
マルチバイト文字のシーケンスの解釈
_mbsnbset, _mbsnbset_l
memset, wmemset
strcat、 wcscat、 _mbscat
strcmp、 wcscmp、 _mbscmp
strcpy、 wcscpy、 _mbscpy
_strnset、 _strnset_l、 _wcsnset、 _wcsnset_l、 _mbsnset、 _mbsnset_l