_strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l

Статья
04/10/2013

Поместите символы строки на символ.Здесь представлены версии _strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l с усовершенствованной безопасностью, как описано в разделе Средства безопасности в CRT.

Важно
_mbsset_s и _mbsset_s_l нельзя использовать в приложениях, выполняемых в среды выполнения Windows.Дополнительные сведения см. в разделе Функции CRT не поддерживаются при /ZW.

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

Параметры

str
Объединения завершенной строка, настройку.
numberOfElements
Размер буфера str.
c
Параметр символов.
locale
Языковой стандарт, который необходимо использовать.

Возвращаемое значение

Ноль, если оно завершится успешно, в противном случае код ошибки.

Эти функции проверяют их аргументов.Если указатель str, либо аргумент numberOfElements меньше или равно 0, или объединения не завершит блок, в, а затем вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров.Если среда выполнения может продолжить, эти функции возвращают EINVAL и errno задается значение EINVAL.

Заметки

Функция _strset_s устанавливает все символы str к преобразованному на c ( char), за исключением конечное нуля-символа._wcsset_s и _mbsset_s — двубайтовая и многобайтовая символьные версии _strset_s.Типы данных аргументов и возвращаемых значений от соответственно.В остальном эти функции ведут себя идентично.

Выходное значение зависеть на параметром параметра категории LC_CTYPE языкового стандарта; дополнительные сведения см. в разделе setlocale.Версии этих функций без суффикса _l используют текущий языковой стандарт для данной функциональности, зависящей от языкового стандарта; версии с суффиксом _l идентичны, за исключением того, что они используют переданный параметр языкового стандарта.Для получения дополнительной информации см. Языковой стандарт.

Отладочные версии этих функций сначала заполняют буфер значением 0xFD.Для отключения данного поведения используйте _CrtSetDebugFillThreshold.

Универсальное текстовое сопоставление функций

Функция TCHAR.H	неопределенные _UNICODE & _MBCS	определенные _MBCS	Определение _UNICODE
_tcsset_s	_strset_s	_mbsset_s	_wcsset_s
_tcsset_s_l	_strset_s_l	_mbsset_s_l	_wcsset_s_l

Требования

Функция	Требуемый заголовок
_strset_s	<string.h>
_strset_s_l	<tchar.h>
_wcsset_s	<string.h> или <wchar.h>
_wcsset_s_l	<tchar.h>
_mbsset_s, _mbsset_s_l	<mbstring.h>

Дополнительные сведения о совместимости см. в разделе Совместимость во введении.

Пример

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