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

void * restrict ptr,
errno_t error

) ;
(desde C11)

La función simplemente retorna al llamador sin realizar ninguna otra acción.

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 que no hace nada.

Como con todas las funciones con verificación de límites, ignore_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 a cadena de caracteres que describe el error
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 - el error que está a punto de ser devuelto por la función llamadora, si resulta ser una de las funciones que devuelven errno_t

Valor de retorno

(ninguno)

Notas

Si ignore_handler_s se utiliza como el manejador de restricciones de tiempo de ejecución, las violaciones pueden detectarse examinando los resultados de las llamadas a funciones con verificación de límites, que pueden ser diferentes para diferentes funciones ( errno_t distinto de cero, carácter nulo escrito en el primer byte de la cadena de salida, etc.)

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.3 La función ignore_handler_s (p: 606)

Véase también

(C11)
callback de abortar para las funciones con verificación de límites
(función)
(C11)
establecer el callback de error para funciones con verificación de límites
(función)