NAME

xt_fgetline() - Read a line from a FILE stream, discarding newline

LIBRARY

#include <xtend/file.h>
-lxtend

SYNOPSIS

size_t  xt_fgetline(FILE *fp, char *buff, size_t maxlen)

ARGUMENTS

fp:     Input stream from which to read
buff:   Character array into which line is read
maxlen: Size of array buff, not counting null byte

DESCRIPTION

xt_fgetline() reads a line of text from a FILE stream. Input is terminated when a newline or end of file is encountered, or when maxlen characters have been read. Note that up to maxlen characters may be stored, NOT INCLUDING THE NULL TERMINATOR BYTE, hence the buffer should be at least maxlen+1 bytes long. Unlike fgets(3), fgetline() does not store the trailing newline character in the string.

RETURN VALUES

The number of bytes read, or EOF if EOF is encountered before a newline

SEE ALSO

fgets(3)