puts

 

C

Language

Headers

Type support

Program utilities

Variadic function support

Error handling

Dynamic memory management

Strings library

Algorithms

Numerics

Date and time utilities

Input/output support

Localization support

Concurrency support (哋它亢11)

Technical Specifications

Symbol index

 

File input/output

Types and objects
FILE fpos_t      stdinstdoutstderr
Functions
File access fopenfopen_s (哋它亢11) freopenfreopen_s (哋它亢11) fwide (哋它亢95) setbuf setvbuf fclose fflush Direct input/output fread fwrite Unformatted input/output fgetc fgets fputc fputs getchar getsgets_s (until 哋它亢11)(哋它亢11) putchar puts ungetc fgetwcgetwc (哋它亢95)(哋它亢95) fgetws (哋它亢95) fputwcputwc (哋它亢95)(哋它亢95) fputws (哋它亢95) getwchar (哋它亢95) putwchar (哋它亢95) ungetwc (哋它亢95) Formatted input scanffscanfsscanfscanf_sfscanf_ssscanf_s (哋它亢11)(哋它亢11)(哋它亢11) wscanffwscanfswscanfwscanf_sfwscanf_sswscanf_s (哋它亢95)(哋它亢95)(哋它亢95)(哋它亢11)(哋它亢11)(哋它亢11)     vscanfvfscanfvsscanfvscanf_svfscanf_svsscanf_s (哋它亢99)(哋它亢99)(哋它亢99)(哋它亢11)(哋它亢11)(哋它亢11) vwscanfvfwscanfvswscanfvwscanf_svfwscanf_svswscanf_s (哋它亢99)(哋它亢99)(哋它亢99)(哋它亢11)(哋它亢11)(哋它亢11)	Formatted output printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (哋它亢99)(哋它亢11)(哋它亢11)(哋它亢11)(哋它亢11) wprintffwprintfswprintfwprintf_sfwprintf_sswprintf_ssnwprintf_s (哋它亢95)(哋它亢95)(哋它亢95)(哋它亢11)(哋它亢11)(哋它亢11)(哋它亢11)     vprintfvfprintfvsprintfvsnprintfvprintf_svfprintf_svsprintf_svsnprintf_s (哋它亢99)(哋它亢11)(哋它亢11)(哋它亢11)(哋它亢11) vwprintfvfwprintfvswprintfvwprintf_svfwprintf_svswprintf_svsnwprintf_s (哋它亢95)(哋它亢95)(哋它亢95)(哋它亢11)(哋它亢11)(哋它亢11)(哋它亢11) File positioning ftell fgetpos fseek fsetpos rewind Error handling clearerr feof ferror perror Operations on files remove rename tmpfiletmpfile_s (哋它亢11) tmpnamtmpnam_s (哋它亢11)

 

Defined in header <stdio.h>
int puts( const char* str );

Writes every character from the null-terminated string str and one additional newline character '\n' to the output stream stdout, as if by repeatedly executing fputc.

The terminating null character from str is not written.

Parameters

str

-

character string to be written

Return value

On success, returns a non-negative value.

On failure, returns EOF and sets the error indicator (see ferror()) on stream.

Notes

The puts function appends the newline character to the output, while fputs function does not.

Different implementations return different non-negative numbers: some return the last character written, some return the number of characters written (or INT_MAX if the string was longer than that), some simply return a non-negative constant.

A typical cause of failure for puts is running out of space on the file system, when stdout is redirected to a file.

Example

Run this code

#include <stdio.h>
 
int main(void)
{
    int rc = puts("Hello World");
 
    if (rc == EOF)
        perror("puts()"); // POSIX requires that errno is set
}

Output:

Hello World

References

• 哋它亢23 standard (ISO/IEC 9899:2023):

• 7.21.7.9 The puts function (p: TBD)

• 哋它亢17 standard (ISO/IEC 9899:2018):

• 7.21.7.9 The puts function (p: TBD)

• 哋它亢11 standard (ISO/IEC 9899:2011):

• 7.21.7.9 The puts function (p: 333)

• 哋它亢99 standard (ISO/IEC 9899:1999):

• 7.19.7.10 The puts function (p: 299)

• 哋它亢89/C90 standard (ISO/IEC 9899:1990):

• 7.9.7.10 The puts function

See also

fputs	writes a character string to a file stream (function)
printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (哋它亢99)(哋它亢11)(哋它亢11)(哋它亢11)(哋它亢11)	prints formatted output to stdout, a file stream or a buffer (function)