std:: puts
| I/O manipulators | ||||
| Print functions (C++23) | ||||
| C-style I/O | ||||
| Buffers | ||||
|
(C++23)
|
||||
|
(
C++98/26*
)
|
||||
|
(C++20)
|
||||
| Streams | ||||
| Abstractions | ||||
| File I/O | ||||
| String I/O | ||||
| Array I/O | ||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(
C++98/26*
)
|
||||
|
(
C++98/26*
)
|
||||
|
(
C++98/26*
)
|
||||
| Synchronized Output | ||||
|
(C++20)
|
||||
| Types | ||||
| Error category interface | ||||
|
(C++11)
|
||||
|
(C++11)
|
| Types and objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Défini dans l'en-tête
<cstdio>
|
||
|
int
puts
(
const
char
*
str
)
;
|
||
Écrit chaque caractère de la chaîne terminée par un caractère nul
str
et un caractère de nouvelle ligne supplémentaire
'
\n
'
dans le flux de sortie
stdout
, comme en exécutant de manière répétée
std::fputc
.
Le caractère nul de terminaison de
str
n'est pas écrit.
Table des matières |
Paramètres
| str | - | chaîne de caractères à écrire |
Valeur de retour
En cas de succès, retourne une valeur non négative
En cas d'échec, retourne
EOF
et définit l'indicateur
d'erreur
(voir
std::ferror
) sur
stdout
.
Notes
La fonction
std::puts
ajoute le caractère de nouvelle ligne à la sortie, tandis que
std::fputs
ne le fait pas.
Différentes implémentations renvoient des nombres non négatifs différents : certaines renvoient le dernier caractère écrit, certaines renvoient le nombre de caractères écrits (ou INT_MAX si la chaîne était plus longue que cela), certaines renvoient simplement une constante non négative.
Une cause typique d'échec pour
std::puts
est l'épuisement de l'espace sur le système de fichiers, lorsque
stdout
est redirigé vers un fichier.
Exemple
#include <cstdio> int main() { int rc = std::puts("Hello World"); if (rc == EOF) std::perror("puts()"); // POSIX requires that errno is set }
Sortie :
Hello World
Voir aussi
|
écrit une chaîne de caractères dans un flux de fichier
(fonction) |
|
|
(C++11)
|
imprime une sortie formatée vers
stdout
, un flux de fichier ou un tampon
(fonction) |
|
Documentation C
pour
puts
|
|