GETS(3S) GETS(3S)
НАЗВАНИЕ
gets, fgets - чтение цепочки символов из потока
СИНТАКСИС
#include
char *gets (s)
char *s;
char *fgets (s, n, stream)
char *s;
int n;
FILE *stream;
ОПИСАНИЕ
Функция gets читает символы из стандартного потока вво-
да stdin в область памяти, на которую указывает аргу-
мент s. Чтение производится до тех пор, пока не встре-
тится перевод строки или конец файла. Символ перевода
строки отбрасывается, а прочитанная цепочка ограничива-
ется нулевым байтом.
Функция fgets считывает (n-1) символов из потока ввода
stream в область памяти, на которую указывает аргумент
s. Чтение производится до тех пор, пока не встретится
перевод строки (в отличие от gets он не отбрасывается)
или конец файла. Прочитанная цепочка символов ограничи-
вается нулевым байтом.
СМ. ТАКЖЕ
ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S),
stdio(3S).
ДИАГНОСТИКА
Если первым прочитанным символом окажется признак конца
файла, то есть фактически ни одного символа не будет
считано, то обе функции возвращают пустой указатель
NULL. Если обнаружена ошибка чтения, например, при по-
пытке использовать эти функции для файлов, не открытых
на чтение, то также возвращается NULL. В остальных слу-
чаях возвращается значение указателя s.
|