man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2014
 
 

puts(3C)

Name

puts, fputs - put a string on a stream

Synopsis

#include <stdio.h>

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

Description

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

The fputs() function writes the null-terminated string pointed to by s to the named output stream. 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 fputs() and the next successful completion of a call to fflush(3C) or fclose(3C) on the same stream or a call to exit (2) or abort(3C).

Return Values

On successful completion, both functions return the number of bytes written; otherwise they return EOF and set errno to indicate the error.

Errors

Refer to fputc(3C).

Usage

Unlike puts(), the fputs() function does not write a NEWLINE character at the end of the string.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe
Standard

See also

exit(2), write(2), Intro(3), abort(3C), fclose(3C), ferror(3C), fflush(3C), fopen(3C), fputc(3C), printf(3C), stdio(3C), attributes(5), standards(5)