This function reads a newline terminated line from the file. The file is identified by function pRo->fpGetCharacter and the pointer fp.
When the input buffer is too small it automatically increases the buffer. The terminating new line is included in the buffer. If the last line of the file is not terminated by newline an extra newline character is added to this last line.
The addition of this extra newline character can be switched off setting pRo->fForceFinalNL
to false. Even if this variable is false the normal newline characters which are present
in the file are included in the buffer.
int reader_gets(pReadObject pRo,
void *fp
){