- 论坛徽章:
- 4
|
- NAME
- fgets - get a string from a stream
- SYNOPSIS
- #include <stdio.h>
- char *fgets(char *restrict s, int n, FILE *restrict stream);
- DESCRIPTION
- The fgets() function shall read bytes from stream into the array pointed to by s, until n-1 bytes are read, or a <newline> is read and trans-
- ferred to s, or an end-of-file condition is encountered. The string is then terminated with a null byte.
- The fgets() function may mark the st_atime field of the file associated with stream for update. The st_atime field shall be marked for update
- by the first successful execution of fgetc(), fgets(), fgetwc(), fgetws(), fread(), fscanf(), getc(), getchar(), gets(), or scanf() using
- stream that returns data not supplied by a prior call to ungetc() or ungetwc().
- RETURN VALUE
- Upon successful completion, fgets() shall return s. If the stream is at end-of-file, the end-of-file indicator for the stream shall be set and
- fgets() shall return a null pointer. If a read error occurs, the error indicator for the stream shall be set, fgets() shall return a null
- pointer, and shall set errno to indicate the error.
复制代码 |
|