_strdate_s, _wstrdate_s

Статья
04/10/2013

Скопируйте текущую дату системы в буфер.эти версии _strdate, _wstrdate со службами расширений безопасности, как описано в разделе Средства безопасности в CRT.

errno_t _strdate_s(
   char *buffer,
   size_t numberOfElements
);
errno_t _wstrdate_s(
   wchar_t *buffer,
   size_t numberOfElements
);
template <size_t size>
errno_t _strdate_s(
   char (&buffer)[size]
); // C++ only
template <size_t size>
errno_t _wstrdate_s(
   wchar_t (&buffer)[size]
); // C++ only

Параметры

[исходящий] buffer
Указатель на буфер, который будет заполнен с форматируемой дате в символьном представлении.
[входящий] numberOfElements
Размер буфера.

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

Нуль, если успешно.Возвращаемое значение кода ошибки, если сбой.Коды ошибок, определенные в ERRNO.H; см. таблицу ниже точные ошибок, создаваемых этой функцией.Дополнительные сведения о кодах ошибок см. в разделе errno.

Условия возникновения ошибок

buffer	numberOfElements	Return	Содержимое buffer
NULL	(все)	EINVAL	Не было
NOT NULL (указывающий на допустимый буфер)	0	EINVAL	Не было
NOT NULL (указывающий на допустимый буфер)	0 < numberOfElements < 9	EINVAL	Пустая строка
NOT NULL (указывающий на допустимый буфер)	numberOfElements >= 9	0	Текущая дата в формате как указано в примечаниями

Вопросы безопасности

Передача в недопустимое non NULL значение для буфера приведет к созданию при Нарушении прав доступа numberOfElements параметр больше 9.

Передача значения размера, который превышает фактический размер buffer приведет к заскоке буфера.

Заметки

Эти функции предоставляют более безопасные версии _strdate и _wstrdate._strdate_s функция копирует текущую дату системы в буфер указанным к которым следуют buffer, форматируется mm/dd/yy, где mm число, представляющее месяц 2 dd 2 цифр, представляющих день, а также yy последние цифры года 2.например, строка 12/05/99 представляет 5-ое декабря 1999.Буфер должен быть не меньше 9 символов в длину.

_wstrdate_s версия расширенных символов _strdate_s; аргумент и возвращаемое значение _wstrdate_s характерные черты.Эти функции ведут себя идентично в противном случае.

If buffer a NULL указатель или numberOfElements чем из 9 символов, недопустимый обработчик параметров вызываются, как описано в разделе Проверка параметров.Если выполнение может быть продолжено, то эти функции возвращают -1 и задают errno В EINVAL если буфер NULL или numberOfElements меньше или равно 0 или набор errno В ERANGE If numberOfElements меньше 9.

В C++ с помощью этих функций упрощает перегрузками шаблона; перегруженные методы могут определять длина буфера, автоматически (что устраняет необходимость указать аргумент size) и они могут автоматически заменять старые, non-безопасные функции с их новыми, безопасный копиями.Дополнительные сведения см. в разделе Предоставляйте перегруженный шаблона.

Сопоставление Родов-Текста обычного: