ignore_handler_s
De cppreference.com
| Definido en el archivo de encabezado <stdlib.h>
|
||
void ignore_handler_s( const char * restrict msg,
void * restrict ptr,
errno_t error
);
|
(desde C11) | |
La función simplemente regresa al llamante sin realizar ninguna otra acción.
Se puede pasar un puntero a esta función a set_constraint_handler_s para establecer un manipulador de restricciones durante el tiempo de ejecución.
- Como con todas las funciones verificadas en los límites,
abort_handler_ssólo está garantizado que esté disponible si la implementación define__STDC_LIB_EXT1__y si el usuario define__STDC_WANT_LIB_EXT1__a la constante entera1antes de incluir<stdlib.h>.
Parametros
| msg | - | puntero a la cadena de caracteres que describe el error |
| ptr | - | puntero a un objeto definido por la implementación o a un puntero nulo. Ejemplos de objetos definidos por la implementación son los objetos que dan el nombre de la función que detectó la infracción y el número de línea cuando se detectó la infracción. |
| error | - | el error que está a punto de ser retornado por la función de llamada, si resulta ser una de las funciones que retorna errno_t |
Valor de retorno
(ninguno)
Observaciones
If ignore_handler_s is used as a the runtime constraints handler, the violations may be detected by examining the results of the bounds-checked function calls, which may be different for different functions (non-zero errno_t, null character written to the first byte of the output string, etc)
If set_constraint_handler_s is never called, the default handler is implementation-defined: it may be abort_handler_s, ignore_handler_s, or some other implementation-defined handler.
Ejemplo
Ejecuta 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, "¡Demasiado largo!");
printf("dst = \"%s\", r = %d\n", dst, r);
set_constraint_handler_s(abort_handler_s);
r = strcpy_s(dst, sizeof dst, "¡Demasiado largo!");
printf("dst = \"%s\", r = %d\n", dst, r);
#endif
}
Posible salida:
dst = "", r = 22
abort_handler_s fue llamado en respuesta a una infracción de restricción
de tiempo de ejecución.
La infracción de restricción de tiempo de ejecución fue causada
por la siguiente expresión en strcpy_s:
(s1max <= (s2_len=strnlen_s(s2, s1max)) ) (in string_s.c:62)
Nota a los usuarios finales: Este programa fue terminado como
resultado de un error presente en el software.
Por favor, póngase en contacto con el proveedor de su software
para obtener más ayuda.
Referencias
- Standard C11 (ISO/IEC 9899:2011):
- K.3.6.1.3 The ignore_handler_s function (p: 606)
Véase también
(C11) |
aborta la llamada de retorno para las funciones verificadas en los límites (función) |
| fija la llamada de error para las funciones verificadas en los límites (función) |