std::fgets

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Input/output library
basic_streambuf basic_filebuf basic_stringbuf ios_base basic_ios basic_istream basic_ostream basic_iostream basic_ifstream basic_ofstream basic_fstream basic_istringstream basic_ostringstream basic_stringstream I/O manipulators C-style I/O
C-style I/O
Functions File access fopen freopen fflush fclose setbuf setvbuf Direct input/output fread fwrite Unformatted input/output fgetc fgets fputc fputs getchar gets putchar puts ungetc fgetwc fgetws fputwc fputws getwchar putwchar ungetwc Formatted input/output scanf fscanf sscanf vscanf vfscanf vsscanf (C++11) (C++11) (C++11) printf fprintf sprintf snprintf (C++11) vprintf vfprintf vsprintf vsnprintf (C++11) wscanf fwscanf swscanf vwscanf vfwscanf vswscanf (C++11) (C++11) (C++11) wprintf fwprintf swprintf vwprintf vfwprintf vswprintf File positioning ftell fgetpos fseek fsetpos rewind Error handling clearerr feof ferror perror Operations on files remove rename tmpfile tmpnam

Defined in header <cstdio>
char *fgets( char *str, int count, FILE *stream );

Reads at most count - 1 characters from the given file stream and stores them in str. The produced character string is always NULL-terminated. Parsing stops if end-of-file occurs or a newline character is found, in which case str will contain that newline character.

[edit] Parameters

str	-	string to read the characters to
count	-	the length of str
stream	-	file stream to read the data from

[edit] Return value

str on success, NULL on an error

[edit] See also

scanf fscanf sscanf	reads formatted input from stdin, a file stream or a buffer (function)
gets	reads a character string from stdin (function)
fputs	writes a character string to a file stream (function)