fgets explanation

Can somebody help me understand how fgets works!?!

I'm trying to read a notepad file and i dont understand what exactly happens,for example if i have a file like this

" why does the monkey never
sit on his own tail and
if he did what expression would
he have on his face after "

and i use an fgets() to read the info, will the fgets stop at the end of the line or will it
continue to read as much of the file as its allowed?

So long as the buffer is big enough, it reads exactly one line on each call.

For example, this prints the file.
while ( fgets( buff, sizeof buff, fp ) != NULL ) fputs( buff, stdout );

If the buffer is smaller than a line, then it's filled with as many characters as will fit.

thanks

Quote:

---

Originally Posted by Salem

If the buffer is smaller than a line, then it's filled with as many characters as will fit.

---

As many characters that will fit with the attatched '\0' put at the end of the buffer.
Just Clarifying.

You know, reading one paragraph of the man page for fgets() tells you all this:

Quote:

---

char *fgets(char *s, int size, FILE *stream);

fgets() reads in at most one less than size characters
from stream and stores them into the buffer pointed to by
s. Reading stops after an EOF or a newline. If a newline
is read, it is stored into the buffer. A '\0' is stored
after the last character in the buffer.

---