div
eof
Развернуть Свернуть
Данная статья переведена автоматически. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст. Дополнительные сведения.
Перевод
Текст оригинала
Эта тема еще не получила оценку - Оценить эту тему

_strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l

Поместите символы строки на символ. Здесь представлены версии _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 );
}
Ранее: Введите строку с что-либо.  Далее: ******************************* 

Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.

Была ли вам полезна эта информация?
(1500 символов осталось)

Добавления сообщества

ДОБАВИТЬ
© 2013 Microsoft. Все права защищены.