_strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l

Makale
03/26/2013

Bir dizenin karakter için bir karakter kümesi. Sürümleri bunlar _strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l açıklandığı gibi güvenlik geliştirmeleri ile crt güvenlik özellikleri.

Önemli

_mbsset_sve _mbsset_s_l Windows çalışma zamanı yürütme uygulamalarda kullanılamaz.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

errno_t _strset_s(
   char *str,
   size_t numberOfElements,
   int c 
);
errno_t _strset_s_l(
   char *str,
   size_t numberOfElements,
   int c,
   locale_t locale
);
errno_t _wcsset_s(
   wchar_t *str,
   size_t numberOfElements,
   wchar_t c 
);
errno_t *_wcsset_s_l(
   wchar_t *str,
   size_t numberOfElements,
   wchar_t c,
   locale_t locale
);
errno_t _mbsset_s(
   unsigned char *str,
   size_t numberOfElements,
   unsigned int c 
);
errno_t _mbsset_s_l(
   unsigned char *str,
   size_t numberOfElements,
   unsigned int c,
   _locale_t locale
);

Parametreler

str
Ayarlanacak null sonlandırılmış bir dize.
numberOfElements
Boyutunu str arabellek.
c
Karakter ayarı.
locale
Kullanılacak yerel ayarı.

Dönüş Değeri

Başarılı olursa, sıfır değilse bir hata kodu.

Bu işlevler, bağımsız değişkenleri doğrulayın. str Bir null işaretçi veya numberOfElements 0, küçük veya eşit olmayan bağımsız değişken veya geçirilen block boşla sonlandırılmış değil, sonra da açıklandığı gibi geçersiz bir parametre işleyici çağrılır Parametre doğrulama. Yürütülmesine devam etmek için izin verilip verilmediğini, bu işlevler dönmek EINVAL ve errno için EINVAL.

Notlar

_strset_s İşlevi ayarlar tipindeki tüm karakterler str için c (dönüştürülmesi için char), sondaki boş karakter hariç. _wcsset_sve _mbsset_s geniş karakter ve çok baytlı karakter sürümleri _strset_s. Bağımsız değişkenleri ve dönüş değerleri veri türlerini buna göre değişir. Bu işlevler aynı şekilde aksi davranır.

Çıkış değeri ayarı tarafından etkilenen LC_CTYPE ; bölgesel ayar kategorisi bkz: setlocale daha fazla bilgi için. Bu işlevler sürümlerini _l soneki kullanan geçerli yerel ayarı için bu yerel ayara bağımlı davranışı; sürümleri ile _l sonek dışında bunun yerine geçirilen yerel ayar parametresi kullandıkları aynı. Daha fazla bilgi için bkz. Yerel ayar.

Bu işlevleri hata ayıklama sürümleri arabellek 0xFD ile doldurun. Bu davranışı devre dışı bırakmak için _CrtSetDebugFillThreshold.

Genel metin eşlemeleri yordamına girildi

TCHAR.H yordamına girildi	_UNICODE & _mbcs tanımlanmamış	Tanımlanan _mbcs	Tanımlanan _UNICODE
_tcsset_s	_strset_s	_mbsset_s	_wcsset_s
_tcsset_s_l	_strset_s_l	_mbsset_s_l	_wcsset_s_l

Gereksinimler

Yordamı	Gerekli başlık
_strset_s	<string.h>
_strset_s_l	<tchar.h>
_wcsset_s	<string.h> veya <wchar.h>
_wcsset_s_l	<tchar.h>
_mbsset_s, _mbsset_s_l	<mbstring.h>

Ek uyumluluk bilgileri için bkz: Uyumluluk giriş.

Örnek

// crt_strset_s.c
#include <string.h>
#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   char string[] = "Fill the string with something.";
   printf( "Before: %s\n", string );
   _strset_s( string, _countof(string), '*' );
   printf( "After:  %s\n", string );
}