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)
Definido en el encabezado <stdlib.h>
void abort_handler_s ( const char * restrict msg,

void * restrict ptr,
errno_t error

) ;
(desde C11)

Escribe un mensaje definido por la implementación a stderr que debe incluir la cadena apuntada por msg y llama a abort() .

Un puntero a esta función puede pasarse a set_constraint_handler_s para establecer un manejador de violaciones de restricciones en tiempo de ejecución.

Como con todas las funciones con verificación de límites, abort_handler_s solo está garantizado que esté disponible si __STDC_LIB_EXT1__ está definido por la implementación y si el usuario define __STDC_WANT_LIB_EXT1__ como la constante entera 1 antes de incluir <stdlib.h> .

Contenidos

Parámetros

msg - puntero al mensaje escrito en el flujo de error estándar
ptr - puntero a un objeto definido por la implementación o un puntero nulo. Ejemplos de objetos definidos por la implementación son objetos que proporcionan el nombre de la función que detectó la violación y el número de línea cuando se detectó la violación
error - un valor positivo de tipo errno_t

Valor de retorno

ninguno; esta función no retorna a su llamador

Notas

Si set_constraint_handler_s nunca es llamado, el manejador predeterminado está definido por la implementación: puede ser abort_handler_s , ignore_handler_s , u otro manejador definido por la implementación.

Ejemplo

Ejecutar este código 
#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
}

Salida posible: 

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

Referencias

  • Estándar C11 (ISO/IEC 9899:2011):
  • K.3.6.1.2 La función abort_handler_s (p: 605)

Véase también

(C11)
función de retorno de ignorar para las funciones con verificación de límites
(función)
(C11)
establecer la función de retorno de error para las funciones con verificación de límites
(función)