ИМЯ¶

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

БИБЛИОТЕКА¶

Стандартная библиотека языка C (libc, -lc)

СИНТАКСИС¶

#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().

If status has a nonzero value, then error() calls exit(3) to terminate the program using the given value as the exit status; otherwise it returns after printing the error message.

Функция 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).

The internal error_one_per_line variable is accessed (without any form of synchronization, but since it's an int used once, it should be safe enough) and, if error_one_per_line is set nonzero, the internal static variables (not exposed to users) used to hold the last printed filename and line number are accessed and modified without synchronization; the update is not atomic and it occurs before disabling cancelation, so it can be interrupted only after one of the two variables is modified. After that, error_at_line() is very much like error().

СТАНДАРТЫ¶

Эти функции и глобальные переменные являются расширениями GNU, и они не должны использоваться в переносимых программах.

СМОТРИТЕ ТАКЖЕ¶

err(3), errno(3), exit(3), perror(3), program_invocation_name(3), strerror(3)

ПЕРЕВОД¶

Русский перевод этой страницы руководства разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.