Namespaces
Variants

abort_handler_s

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

void * restrict ptr,
errno_t error

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

Записывает определяемое реализацией сообщение в stderr , которое должно включать строку, на которую указывает msg , и вызывает abort() .

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

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

Содержание

Параметры

msg - указатель на сообщение, записанное в стандартный поток ошибок
ptr - указатель на объект, определяемый реализацией, или нулевой указатель. Примерами объектов, определяемых реализацией, являются объекты, содержащие имя функции, обнаружившей нарушение, и номер строки, в которой было обнаружено нарушение
error - положительное значение типа 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.2 Функция abort_handler_s (стр: 605)

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

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