pSOSystem System Calls - Read

pREPC+ System Calls fgets
fgets Gets a string from a stream.
#include
#include
char *fgets(
char *s, /* buffer */
int n, /* length */
FILE *stream /* stream pointer */
)
Description
Arguments
Return Value
Error Codes
The fgets() function reads at most one less than the number of characters
specified by n from the stream pointed to by stream. The characters go into the
user buffer pointed to by s. The function stops reading characters when a new-line
character (which is retained) or an end-of-file condition is detected. A null character
is written immediately after the last character is read into the user buffer.
If stream references a disk file, its position indicator is advanced.
s Points to the user buffer where fgets() stores characters.
n Specifies the number of characters to read, plus one for the
null terminator.
stream Points to an open pREPC+ stream.
This function returns s if successful. If a read error occurs or an end-of-file
condition is detected before any characters are read, a null pointer is returned and
errno is set.
Refer to Appendix B.
pSOSystem System Calls 3-37
3