Cher: Created page with 'Навигация: Главная страница/Система ejudge/Проверяющие программы/libchecker/[[Libchecker:Функци…'

2010-07-04T20:02:57Z

Created page with 'Навигация: Главная страница/Система ejudge/Проверяющие программы/libchecker/[[Libchecker:Функци…'

New page

Навигация: [[Main Page|Главная страница]]/[[Система ejudge]]/[[Проверяющие программы]]/[[libchecker]]/[[Libchecker:Функции|Функции]]/[[Libchecker:Чтение файла как текста|Чтение файла как текста]]/<tt>[[Libchecker:checker_read_buf_ex|checker_read_buf_ex]]</tt>

Функция <tt>checker_read_buf_ex</tt> — чтение одного [[элемент ввода|элемента ввода]] из [[текстовый файл|текстового файла]].

char *
checker_read_buf_ex(
FILE *f,
[[libchecker:checker_error_func_t|checker_error_func_t]] error_func,
const char *name,
int eof_error_flag,
char *sbuf,
size_t ssz,
char **pdbuf,
size_t *pdsz);

Функция считывает один [[элемент ввода]] из [[текстовый файл|текстового файла]] <tt>f</tt> в память. Пробельные символы, возможно находящиеся во входном файле перед элементом ввода, игнорируются.

Параметр <tt>name</tt> — это дополнительный пояснительный текст, который будет выводиться в случае ошибки. В частности, этот текст может задавать название считываемого из файла параметра (например, <tt>"имя узла графа"</tt>).
Параметр <tt>eof_error_flag</tt> определяет, должна ли диагностироваться ошибка в случае, если выполняется попытка чтения элемента ввода после конца файла. Если параметр <tt>eof_error_flag</tt> равен 0, то при попытке чтения после конца файла функция просто вернет значение NULL.
Если же этот параметр имеет ненулевое значение, то при достижении конца файла будет вызвана функция вывода сообщения об ошибке, переданная в параметре <tt>error_func</tt>.

Если параметр <tt>pdbuf</tt> равен NULL или параметр <tt>pdsz</tt> равен NULL, то функция выполняет чтение элемента ввода в буфер ограниченного размера. Параметр <tt>sbuf</tt> задает адрес буфера, а <tt>ssz</tt> — его размер. Если элемент ввода имеет длину, большую, чем ssz - 1, то есть не умещается в буфер, вызывается функция <tt>error_func</tt> для выдачи сообщения об ошибке и завершения работы. В конец считанного элемента ввода добавляется нулевой байт. Функция возвращает адрес начала буфера (то есть значение параметра <tt>sbuf</tt>), либо NULL при попытке чтения после конца файла при значении параметра <tt>eof_error_flag</tt> равном 0.

Если параметр <tt>sbuf</tt> равен NULL или параметр <tt>ssz</tt> не превосходит 0, то функция выполняет чтение элемента ввода в динамическую память. В результате работы функции переменная, на которую указывает параметр <tt>pdbuf</tt>, будет содержать адрес считанного элемента ввода, а переменная, на которую указывает параметр <tt>pdsz</tt>, длину считанного элемента ввода (без учета завершающего нулевого байта). В конец считанного элемента ввода добавляется нулевой байт. Память для содержимого строки выделяется на куче с помощью функций <tt>[[libchecker:xmalloc|xmalloc]]</tt> и <tt>[[libchecker:xrealloc|xrealloc]]</tt>. Функция возвращает адрес начала считанной строки, либо NULL при попытке чтения после конца файла при значении параметра <tt>eof_error_flag</tt> равном 0.

Если параметр <tt>sbuf</tt> не равен NULL, параметр <tt>ssz</tt> больше 0, параметры <tt>pdbuf</tt> и <tt>pdsz</tt> не равны NULL, функция работает как комбинация двух вышеописанных режимов работы. Если длина элемента ввода такова, что он помещается в буфер <tt>sbuf</tt> размера <tt>ssz</tt>, то динамическая память не используется, и возвращается значение <tt>sbuf</tt>. Если же элемент ввода длиннее буфера, то он будет размещен в динамической памяти, и будет возвращен адрес начала считанной строки.

Функция не предназначена для работы с бинарными файлами. Если при чтении из файла был считан символ, который не можен находиться в текстовом файле, вызывается функция <tt>error_func</tt> для вывода сообщения об ошибке и завершения работы.

Если при чтении произошла ошибка ввода, программа завершается, и диагностируется [[внутренняя ошибка проверки]]. Для этого используется функция <tt>[[libchecker:fatal_CF|fatal_CF]]</tt>.

Libchecker:checker read buf ex - Revision history

Cher: Created page with 'Навигация: Главная страница/Система ejudge/Проверяющие программы/libchecker/[[Libchecker:Функци…'