gets()

get string from standard input 

Function

SYNOPSIS

#include <stdio.h>

char *gets(char *s);

DESCRIPTION

The gets() function reads characters from stdin and loads them into the buffer pointed to by s. No additional characters are read after gets() has read a linefeed. A null character is written immediately after the last character that gets() reads into the buffer. Unlike fgets(), gets() does not copy the linefeed to the buffer.

PARAMETERS

s 

Points to the input buffer.

RETURN VALUES

If successful, gets() returns s, the address of the input buffer. If end-of-file is encountered and no characters have been read into the buffer, the buffer's contents remain unchanged and a null pointer is returned. If a read error occurs , a null pointer is returned and the error indicator for the stream is set. The functions ferror() and feof() can be used to distinguish error conditions from end-of-file.

On failure, errno is set to one of the following values:

EACCES 

Another process has the file locked.

EBADF 

stdin is not a valid stream opened for reading.

EINTR 

A signal interrupted the call.

EIO 

An input error occurred.

EISDIR 

The open object is a directory, not a file.

ENOMEM 

Memory could not be allocated for internal buffers.

ENXIO 

A device error occurred.

EOVERFLOW 

The file is a regular file and an attempt was made to read at or beyond the offset maximum associated with the corresponding stream.

EWOULDBLOCK 

The underlying file descriptor is a non-blocking socket and no data is ready to be read.

CONFORMANCE

ANSI/ISO 9899-1990.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

For files opened in text mode, the character sequence carriage-return linefeed is translated into linefeed. No such translation occurs for files opened in binary mode.

AVAILABILITY

MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
feof(), ferror(), fgets(), fopen(), fscanf()

MKS Toolkit 9.2 Documentation Build 16.