Man page - error(3)

Packages contains this manual

Package:  libvolpack1-dev
apt-get install libvolpack1-dev

Documentations in package:
• libvolpack1-dev

Available languages:

en fr ja ru ro

Manual

error

НАИМЕНОВАНИЕ
БИБЛИОТЕКА
ОБЗОР
ОПИСАНИЕ
АТРИБУТЫ
СТАНДАРТЫ
СМОТРИТЕ ТАКЖЕ
ПЕРЕВОД

---

НАИМЕНОВАНИЕ

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> и Kirill Rekhov <krekhov.dev@gmail.com>

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

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

---