ERROR(3)

ИМЯ
error, error_at_line, error_message_count, error_one_per_line, error_print_progname - функции вывода ошибок glibc

ОБЗОР
#include <error.h>

void error(int status, int errnum, const char *format, ...);

void error_at_line(int status, int errnum, const char *filename,
                   unsigned int linenum, const char *format, ...);

extern unsigned int error_message_count;

extern int error_one_per_line;

extern void (*error_print_progname) (void);

ОПИСАНИЕ
Функция error() предназначена для сообщения об ошибках разного рода. Она сбрасывает stdout, а затем выводит в stderr имя программы, двоеточие, пробел, сообщение, задаваемое строкой format в формате printf(3) и, если значение errnum не равно нулю, второе двоеточие и пробел, за которыми выводится строка, возвращаемая вызовом strerror(errnum). Все аргументы, необходимые для format, должны указываться в списке аргументов после format. Вывод завершается символом новой строки.

Имя программы, выводимое error(), представляет собой значение глобальной переменной program_invocation_name(3). Первоначально, переменная program_invocation_name имеет то же значение что и argv[0] в функции main(). Значение этой переменной может быть изменено для показа в выводе error().

Если значение status не равно нулю, то error() вызывает exit(3) для завершения программы и это значение используется как код выхода.

Функция error_at_line() делает то же что и error(), но имеет дополнительные аргументы filename и linenum. Вывод аналогичен error(), но после имени программы записывается: двоеточие, значение filename, двоеточие и значение linenum. При вызове error_at_line() могут быть полезны значения препроцессора __LINE__ и __FILE__, но можно использовать и другие значения. Например, эти аргументы могут указывать на место во входном файле.

Если значение глобальной переменной error_one_per_line не равно нулю, то последовательность вызовов error_at_line() с тем же значением filename и linenum выводит только одно сообщение (первое).

В глобальной переменной error_message_count подсчитывается количество сообщений, которые были показаны с помощью error() и error_at_line().

Если глобальной переменной error_print_progname назначен адрес функции (т.е., её значение не равно NULL), то вместо показа в начале сообщения имени программы и двоеточия вызывается эта функция. Функция должна вывести нужную строку в stderr.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
error() | Безвредность в нитях | MT-Safe locale
error_at_line() | Безвредность в нитях | MT-Unsafe race: error_at_line/error_one_per_line locale

Доступна внутренняя переменная error_one_per_line (нет никакой синхронизации, но так как этот int используется только один раз, это не проблема) и, если error_one_per_line установлена в ненулевое значение, то становятся доступны для чтения и изменения без синхронизации внутренние статические переменные (невидимые пользователю), которые используются для хранения последнего напечатанного имени файла и номера строки; обновление не атомарно и происходит прежде, чем отключить отмену, поэтому может быть прервано только после того, как одна из этих двух переменных изменена. После этого error_at_line() очень похожа на error().

СООТВЕТСТВИЕ СТАНДАРТАМ
Эти функции и глобальные переменные являются расширениями GNU, и они не должны использоваться в переносимых программах.

СМОТРИТЕ ТАКЖЕ
err(3), errno(3), exit(3), perror(3), program_invocation_name(3), strerror(3)