www.delorie.com/djgpp/doc/libc/libc_320.html   search  
libc.a reference

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

fgets

Syntax

 
#include <stdio.h>

char *fgets(char *buffer, int maxlength, FILE *file);

Description

This function reads as much of a line from a file as possible, stopping when the buffer is full (maxlength-1 characters), an end-of-line is detected, or EOF or an error is detected. It then stores a NULL to terminate the string.

Return Value

The address of the buffer is returned on success, if EOF is encountered before any characters are stored, or if an error is detected, NULL is returned instead.

Portability

ANSI/ISO C C89; C99
POSIX 1003.2-1992; 1003.1-2001

Example

 
char buf[100];
while (fgets(buf, 100, stdin))
  fputs(buf, stdout);


  webmaster   donations   bookstore     delorie software   privacy  
  Copyright 2004   by DJ Delorie     Updated Apr 2004