Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > P

puts(3S)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

puts(), fputs() — put a string on a stream

SYNOPSIS

#include <stdio.h>

int puts(const char *s);

int fputs(const char *__restrict s, FILE *__restrict stream);

Obsolescent Interfaces

int puts_unlocked(const char *s);

int fputs_unlocked(const char *s, FILE *stream);

DESCRIPTION

puts() writes the null-terminated string pointed to by s, followed by a new-line character, to the standard output stream stdout.

fputs() writes the null-terminated string pointed to by s to the named output stream, but does not append a new-line character.

Neither function writes the terminating null character.

Notes

puts() and puts_unlocked() append a new-line character; fputs() and fputs_unlocked() do not.

Obsolescent Interfaces

puts_unlocked() and fputs_unlocked() put a string on a stream.

RETURN VALUE

Upon successful completion, these routines return a non-negative number. Otherwise they return EOF, set the error indicator for the stream, and set errno to indicate the error.

ERRORS

These routines fail if, either the stream is unbuffered or stream's buffer needed to be flushed causing an underlying write() call to be invoked, and:

EAGAIN

The O_NONBLOCK flag is set for the file descriptor underlying stream and the process would be delayed in the write operation.

EBADF

The file descriptor underlying stream is not a valid file descriptor open for writing.

EFBIG

An attempt was made to write to a file that exceeds the process's file size limit or the maximum file size (see ulimit(2)).

EINTR

A signal was caught during the write() system call.

[EIO]

The process is in a background process group and is attempting to write to its controlling terminal, TOSTOP is set, the process is neither ignoring nor blocking the SIGTTOU signal, and the process group of the process is orphaned.

ENOSPC

There was no free space remaining on the device containing the file.

EPIPE

An attempt is made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal is also sent to the process.

Additional errno values may be set by the underlying write() function (see write(2)).

WARNINGS

puts_unlocked() and fputs_unlocked() are obsolescent interfaces supported only for compatibility with existing DCE applications. New multithreaded applications should use puts() and fputs().

STANDARDS CONFORMANCE

puts(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

fputs(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.