abort_handler_s
De cppreference.com
| Definido en el archivo de 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().
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 al mensaje escrito en el canal de errores estándar |
| 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 | - | un valor positivo de tipo errno_t |
Valor de retorno
ninguna; esta función no retorna a su llamante
Observaciones
Si set_constraint_handler_s nunca se llama, el gestor predeterminado es el definido por la implementación: puede ser abort_handler_s, ignore_handler_s, o algún otro gestor definido por la implementación.
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.2 The abort_handler_s function (p: 605)
Véase también
(C11) |
ignorar 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) |