1  /* Declaration for error-reporting function
       2     Copyright (C) 1995-1997, 2003, 2006, 2008-2022 Free Software Foundation,
       3     Inc.
       4     This file is part of the GNU C Library.
       5  
       6     This file is free software: you can redistribute it and/or modify
       7     it under the terms of the GNU Lesser General Public License as
       8     published by the Free Software Foundation; either version 2.1 of the
       9     License, or (at your option) any later version.
      10  
      11     This file is distributed in the hope that it will be useful,
      12     but WITHOUT ANY WARRANTY; without even the implied warranty of
      13     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      14     GNU Lesser General Public License for more details.
      15  
      16     You should have received a copy of the GNU Lesser General Public License
      17     along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
      18  
      19  #ifndef _ERROR_H
      20  #define _ERROR_H 1
      21  
      22  /* Get _GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, _GL_ATTRIBUTE_SPEC_PRINTF_SYSTEM.  */
      23  #include <stdio.h>
      24  
      25  #ifdef __cplusplus
      26  extern "C" {
      27  #endif
      28  
      29  /* Print a message with 'fprintf (stderr, FORMAT, ...)';
      30     if ERRNUM is nonzero, follow it with ": " and strerror (ERRNUM).
      31     If STATUS is nonzero, terminate the program with 'exit (STATUS)'.  */
      32  
      33  extern void error (int __status, int __errnum, const char *__format, ...)
      34  #if GNULIB_VFPRINTF_POSIX
      35       _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, 3, 4))
      36  #else
      37       _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_SYSTEM, 3, 4))
      38  #endif
      39       ;
      40  
      41  extern void error_at_line (int __status, int __errnum, const char *__fname,
      42                             unsigned int __lineno, const char *__format, ...)
      43  #if GNULIB_VFPRINTF_POSIX
      44       _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, 5, 6))
      45  #else
      46       _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_SYSTEM, 5, 6))
      47  #endif
      48       ;
      49  
      50  /* If NULL, error will flush stdout, then print on stderr the program
      51     name, a colon and a space.  Otherwise, error will call this
      52     function without parameters instead.  */
      53  extern void (*error_print_progname) (void);
      54  
      55  /* This variable is incremented each time 'error' is called.  */
      56  extern unsigned int error_message_count;
      57  
      58  /* Sometimes we want to have at most one error per line.  This
      59     variable controls whether this mode is selected or not.  */
      60  extern int error_one_per_line;
      61  
      62  #ifdef __cplusplus
      63  }
      64  #endif
      65  
      66  #endif /* error.h */