focal (3) err.3.gz

NOMBRE

     err, verr, errx, verrx, warn, vwarn, warnx, vwarnx, — mensajes de error con formato

SINOPSIS

     #include <err.h>
     void err(int eval, const char *fmt, ...)  void errx(int eval, const char *fmt, ...)  void
     warn(const char *fmt, ...)  void warnx(const char *fmt, ...)  #include <stdarg.h>
     void verr(int eval, const char *fmt, va_list args) void verrx(int eval, const char *fmt,
     va_list args) void vwarn(const char *fmt, va_list args) void vwarnx(const char *fmt, va_list
     args)

DESCRIPCIÓN

     La familia de funciones err() y warn() muestran un mensaje de error con formato en la salida
     estándar de error.  En todos los casos, se imprime el último componente del nombre del
     programa, un carácter punto y un espacio.  Si el argumento fmt es distinto de NULL, se
     imprime un mensaje de error con formato al estilo de printf(3)

     Las funciones err(), verr(), warn(), y vwarn() añaden un mensaje de error obtenido con
     strerror(3) basado en un código o en la variable global errno, precedido por otro punto y un
     espacio a menos que el argumento fmt sea NULL.

     Las funciones err(), verr(), warn(), y vwarn() usan la variable global errno para buscar el
     mensaje de error.

     Las funciones errx() y warnx() no añaden ningún mensaje de error.

     Las funciones err(), verr(), errx(), y verrx() no regresan, sino que terminan la ejecución
     con el valor del argumento eval.

EJEMPLOS

     Muestra la cadena de información del error actual y termina:

           if ((p = malloc(size)) == NULL)
                   err(1, NULL);
           if ((fd = open(file_name, O_RDONLY, 0)) == -1)
                   err(1, "%s", file_name);

     Muestra un mensaje de error y termina:

           if (tm.tm_hour < START_TIME)
                   errx(1, "too early, wait until %s", start_time_string);

     Aviso de un error:

           if (
                   warnx("%s: %s: trying the block device",
                       raw_device, strerror(errno));
           if ((fd = open(block_device, O_RDONLY, 0)) == -1)
                   err(1, "%s", block_device);

VÉASE TAMBIÉN

     exit(3), printf(3), perror(3), strerror(3)

HISTORIA

     Las funciones err() y warn() aparecieron por primera vez en 4.4BSD.