puts()

write string to standard input 

Function

SYNOPSIS

#include <stdio.h>

int puts(const char *s);

DESCRIPTION

The puts() function writes the string pointed to by s to standard output stream stdout and appends a newline character to the output. The string's terminating null character is not written.

After puts() returns, the characters it wrote may be held in an internal buffer either until fflush() or fclose() are executed on stdout, or until the process executes exit() or abort().

PARAMETERS

s 

Is the string to be output.

RETURN VALUES

If successful, the puts() function returns a non-negative value. If an error occurs, it returns EOF and sets errno to one of the following values:

EACCES 

Another process has the file locked.

EBADF 

stdout is not a valid stream opened for writing.

EFBIG 

The file is a regular file and an attempt was made to write at or beyond the offset maximum.

EINTR 

A signal interrupted the call.

EIO 

An output error occurred.

ENOMEM 

Memory could not be allocated for internal buffers.

ENOSPC 

An attempt was made to write to a full disk.

ENXIO 

A device error occurred.

EPIPE 

An attempt was made to write to a closed pipe.

CONFORMANCE

ANSI/ISO 9899-1990.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

If stdout is associated with a file opened in text mode, the trailing linefeed and any embedded linefeed are each translated to carriage-return linefeed on output. No such translation occurs if stdout is 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:
abort(), exit(), fclose(), fflush(), fputs(), putc()

PTC MKS Toolkit 10.4 Documentation Build 39.