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

2008-08-23T10:13:43Z

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

New page

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

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

char *checker_read_buf_2(int ind, const char *name, int eof_error_flag, char *sbuf, size_t ssz, char **pdbuf, size_t *pdsz);

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

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

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

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

Функция не предназначена для работы с бинарными файлами.

Если при чтении произошла ошибка ввода, программа завершается, и диагностируется [[внутренняя ошибка проверки]].

Libchecker:checker read buf 2 - Revision history

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