ОБЗОР
#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(3) очень похожа на error(3).