_strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l

Makale
06/09/2015

Bir dizenin karakterlerini bir karaktere ayarlar.Bu _strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l sürümlerinde CRT'deki Güvenlik Özellikleri içinde açıklandığı gibi güvenlik geliştirmeleri mevcut olabilir.

Önemli
_mbsset_s ve _mbsset_s_l Windows Çalışma Zamanı'nda yürütülen uygulamalarda kullanılamazlar.Daha fazla bilgi için bkz /ZW ile desteklenmeyen CRT işlevleri.

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
Ayarlamak için null ile sonlandırılmış dize.
numberOfElements
str arabelleğinin boyutu.
c
Karakter ayarı.
locale
Kullanılacak yerel ayar.

Dönüş Değeri

Başarılıysa sıfır; aksi halde hata kodu.

Bu işlevler, kendi bağımsız değişkenlerini doğrular.str null bir işaretçiyse veya numberOfElements bağımsız değişkeni 0 değerinden küçük ya da buna eşitse, içinden geçilen blok null sonlandırılansa Parametre Doğrulama konusunda açıklandığı gibi geçersiz parametre işleyicisi çağrılır.Yürütmenin devam etmesine izin verilirse, bu işlevler EINVAL döndürür ve errno öğesini EINVAL olarak ayarlar.

Notlar

_strset_s işlevi str dizesinin tüm karakterlerini, sonlandırıcı null karakteri dışında (char türüne dönüştürülmüş olarak) c karakterine ayarlar._wcsset_s ve _mbsset_s_strset_s öğesinin geniş karakter ve çok baytlı karakter sürümleridir.Bağımsız değişkenlerin ve dönen değerlerin veri türleri buna göre değişir.Bu işlevler, aksi halde aynı şekilde davranır.

Çıkış değeri, yerel ayarın LC_CTYPE kategori ayarından etkilenir; daha fazla bilgi için, bkz. setlocale.Bu işlevlerin, _l sonekine sahip olmayan sürümleri, yerel ayara bağlı davranışı için, geçerli yerel ayarı kullanır; _l sonekine sahip sürümler, bunun yerine iletilmiş yerel ayar parametresini kullanması hariç aynıdır.Daha fazla bilgi için bkz. Yerel Ayar.

Bu işlevlerin hata ayıklama sürümleri arabelleği ilk önce 0xFD ile doldurur.Bu davranışı devre dışı bırakmak için _CrtSetDebugFillThreshold kullanın.

Genel Metin Yordam Eşleşmeleri

TCHAR.H yordamı	_UNICODE & _MBCS tanımlanmamış	_MBCS tanımlanmış	_UNICODE tanımlanmış
_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> or <wchar.h>
_wcsset_s_l	<tchar.h>
_mbsset_s, _mbsset_s_l	<mbstring.h>

Ek uyumluluk bilgileri için bkz. Uyumluluk.

Ö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 );
}