Namespaces
Variants

ignore_handler_s

From cppreference.net
< c ‎ | error
C
Error handling
Error codes
Error codes
Assertions
(C11) (removed in C23)
Bounds checking
(C11)
(C11)
ignore_handler_s
(C11)
Определено в заголовочном файле <stdlib.h>
void ignore_handler_s ( const char * restrict msg,

void * restrict ptr,
errno_t error

) ;
(начиная с C11)

Функция просто возвращается к вызывающей стороне без выполнения каких-либо других действий.

Указатель на эту функцию может быть передан в set_constraint_handler_s для установки обработчика нарушений ограничений времени выполнения, который ничего не делает.

Как и все функции с проверкой границ, ignore_handler_s гарантированно доступна только если __STDC_LIB_EXT1__ определено реализацией и если пользователь определяет __STDC_WANT_LIB_EXT1__ как целочисленную константу 1 перед включением <stdlib.h> .

Содержание

Параметры

msg - указатель на строку символов, описывающую ошибку
ptr - указатель на объект, определяемый реализацией, или нулевой указатель. Примерами объектов, определяемых реализацией, являются объекты, содержащие имя функции, обнаружившей нарушение, и номер строки, в которой было обнаружено нарушение
error - ошибка, которая будет возвращена вызывающей функцией, если она относится к функциям, возвращающим errno_t

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

(нет)

Примечания

Если ignore_handler_s используется в качестве обработчика ограничений времени выполнения, нарушения могут быть обнаружены путем проверки результатов вызовов функций с проверкой границ, которые могут различаться для разных функций (ненулевой errno_t , запись нулевого символа в первый байт выходной строки и т.д.)

Если set_constraint_handler_s никогда не вызывается, обработчик по умолчанию определяется реализацией: это может быть abort_handler_s , ignore_handler_s или какой-либо другой обработчик, определяемый реализацией.

Пример

Запустить этот код 
#define __STDC_WANT_LIB_EXT1__ 1
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
#ifdef __STDC_LIB_EXT1__
    char dst[2];
    set_constraint_handler_s(ignore_handler_s);
    int r = strcpy_s(dst, sizeof dst, "Too long!");
    printf("dst = \"%s\", r = %d\n", dst, r);
    set_constraint_handler_s(abort_handler_s);
    r = strcpy_s(dst, sizeof dst, "Too long!");
    printf("dst = \"%s\", r = %d\n", dst, r);
#endif
}

Возможный вывод: 

dst = "", r = 22
abort_handler_s was called in response to a runtime-constraint violation.
The runtime-constraint violation was caused by the following expression in strcpy_s:
(s1max <= (s2_len=strnlen_s(s2, s1max)) ) (in string_s.c:62)
Note to end users: This program was terminated as a result
of a bug present in the software. Please reach out to your
software's vendor to get more help.
Aborted

Ссылки

  • Стандарт C11 (ISO/IEC 9899:2011):
  • K.3.6.1.3 Функция ignore_handler_s (стр: 606)

Смотрите также

(C11)
функция прерывания для проверяемых на границы функций
(функция)
(C11)
установить функцию обработки ошибок для проверяемых на границы функций
(функция)