_strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l

Mengatur karakter string ke karakter. Versi , , _wcsset_strset_l, _wcsset_l, , _mbsset, ini_mbsset_lmemiliki peningkatan keamanan, seperti yang dijelaskan dalam Fitur keamanan di CRT._strset

Penting

_mbsset_s dan _mbsset_s_l tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime. Untuk informasi selengkapnya, lihat Fungsi CRT yang tidak didukung di aplikasi Platform Windows Universal.

Sintaks

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

Parameter

str
String yang dihentikan null untuk diatur.

numberOfElements
Ukuran str buffer.

c
Pengaturan karakter.

locale
Lokal untuk digunakan.

Nilai hasil

Nol jika berhasil, jika tidak, kode kesalahan.

Fungsi-fungsi ini memvalidasi argumennya. Jika str adalah penunjuk null, atau numberOfElements argumen kurang dari atau sama dengan 0, atau blok yang diteruskan tidak dihentikan null, maka handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, fungsi-fungsi ini kembali EINVAL dan diatur errno ke EINVAL.

Keterangan

Fungsi _strset_s mengatur semua karakter str ke c (dikonversi ke char), kecuali karakter null yang mengakhiri. _wcsset_s dan _mbsset_s adalah versi karakter lebar dan multibyte-character dari _strset_s. Jenis data argumen dan nilai pengembalian bervariasi. Fungsi-fungsi ini berulah secara identik jika tidak.

Nilai output dipengaruhi oleh pengaturan LC_CTYPE pengaturan kategori lokal. Untuk informasi selengkapnya, lihat setlocale . Versi fungsi-fungsi ini tanpa _l akhiran menggunakan lokal saat ini untuk perilaku tergantung lokal ini; versi dengan _l akhiran identik kecuali bahwa mereka menggunakan parameter lokal yang diteruskan sebagai gantinya. Untuk informasi selengkapnya, lihat Lokal.

Versi pustaka debug dari fungsi-fungsi ini terlebih dahulu mengisi buffer dengan 0xFE. Untuk menonaktifkan perilaku ini, gunakan _CrtSetDebugFillThreshold.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

TCHAR. Rutinitas H	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_tcsset_s	_strset_s	_mbsset_s	_wcsset_s
_tcsset_s_l	_strset_s_l	_mbsset_s_l	_wcsset_s_l

Persyaratan

Rutin	Header yang diperlukan
_strset_s	<string.h>
_strset_s_l	<tchar.h>
_wcsset_s	<string.h> atau <wchar.h>
_wcsset_s_l	<tchar.h>
_mbsset_s, _mbsset_s_l	<mbstring.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

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

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

Baca juga

Manipulasi string
Lokal
Interpretasi urutan karakter multibyte
_mbsnbset, _mbsnbset_l
memset, wmemset
strcat, wcscat, _mbscat
strcmp, wcscmp, _mbscmp
strcpy, wcscpy, _mbscpy
_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l