The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

 NAME

puts - put a string on standard output

 SYNOPSIS



#include <stdio.h>

int puts(const char *s);

 DESCRIPTION

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

The st_ctime and st_mtime fields of the file will be marked for update between the successful execution of puts() and the next successful completion of a call to fflush() or fclose() on the same stream or a call to exit() or abort().

 RETURN VALUE

Upon successful completion, puts() returns a non-negative number. Otherwise it returns EOF, sets an error indicator for the stream and errno is set to indicate the error.

 ERRORS

Refer to fputc().

 EXAMPLES

None.

 APPLICATION USAGE

The puts() function appends a newline character, while fputs() does not.

 FUTURE DIRECTIONS

None.

 SEE ALSO

fputs(), fopen(), putc(), stdio(), <stdio.h>.

DERIVATION

Derived from Issue 1 of the SVID.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]