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

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

SEE ALSO

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

PTC MKS Toolkit 10.5 Documentation Build 40.