_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

Mengatur karakter string ke karakter. Versi yang lebih aman dari fungsi-fungsi ini tersedia; lihat _strset_s, , _wcsset_s_strset_s_l, _wcsset_s_l, , . _mbsset_s_l_mbsset_s

Penting

_mbsset dan _mbsset_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

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

Parameter

str
String yang dihentikan null untuk diatur.

c
Pengaturan karakter.

locale
Lokal untuk digunakan.

Nilai hasil

Mengembalikan penunjuk ke string yang diubah.

Keterangan

Fungsi _strset mengatur semua karakter (kecuali karakter null penghentian) dari str ke c, dikonversi ke char. _wcsset dan _mbsset_l adalah versi karakter lebar dan multibyte-character dari _strset, dan jenis data argumen dan nilai pengembalian bervariasi sesuai. Fungsi-fungsi ini berulah secara identik jika tidak.

_mbsset memvalidasi parameternya. Jika str adalah penunjuk null, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, _mbsset mengembalikan NULL dan mengatur errno ke EINVAL. _strset dan _wcsset tidak memvalidasi parameternya.

Nilai output dipengaruhi oleh pengaturan LC_CTYPE pengaturan kategori lokal. Untuk informasi selengkapnya, lihat setlocale . Versi fungsi-fungsi ini identik, kecuali yang tidak memiliki _l akhiran menggunakan lokal saat ini dan yang memiliki _l akhiran sebagai gantinya menggunakan parameter lokal yang diteruskan. Untuk informasi selengkapnya, lihat Lokal.

Penting

Fungsi-fungsi ini mungkin rentan terhadap ancaman buffer yang diserbu. Overruns buffer dapat digunakan untuk serangan sistem karena dapat menyebabkan peningkatan hak istimewa yang tidak beralasan. Untuk informasi selengkapnya, lihat Menghindari overruns buffer.

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	_strset	_mbsset	_wcsset
_tcsset_l	_strset_l	_mbsset_l	_wcsset_l

Persyaratan

Rutin	Header yang diperlukan
_strset	<string.h>
_strset_l	<tchar.h>
_wcsset	<string.h> atau <wchar.h>
_wcsset_l	<tchar.h>
_mbsset, _mbsset_l	<mbstring.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

// 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:  *******************************

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