fputc, putc
Von de.cppreference.net
| Definiert in Header <stdio.h>
|
||
int fputc( int ch, FILE* stream );
|
||
int putc( int ch, FILE* stream );
|
||
Schreibt ein Zeichen chin den gegebenen Ausgabestrom stream. putc()kann als Makro implementiert sein und wertet stream mehr als einmal aus, daher sollte das entsprechende Argument niemals ein Ausdruck mit Nebeneffekten sein.
Intern wird das Zeichen in unsigned char umgewandelt, kurz bevor es geschrieben wird.
Parameter
| ch | - | zu schreibendes Zeichen |
| stream | - | Ausgabestrom |
Rückgabewert
Bei Erfolg wird das geschriebene Zeichen zurückgegeben.
Bei Fehler wird EOF zurückgegeben und der Fehler-Indikator (siehe ferror()) auf stream gesetzt.
Beispiel
Zeigt putc mit Fehlerprüfung
Diesen Code ausführen
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
int ret_code = 0;
for (char c = 'a'; (ret_code != EOF) && (c != 'z'); c++)
ret_code = putc(c, stdout);
// Test whether EOF was reached.
if (ret_code == EOF && ferror(stdout))
{
perror("putc()");
fprintf(stderr, "putc() failed in file %s at line # %d\n",
__FILE__, __LINE__ - 7);
exit(EXIT_FAILURE);
}
putc('\n', stdout);
return EXIT_SUCCESS;
}
Ausgabe:
abcdefghijklmnopqrstuvwxy
Referenzen
- C23-Standard (ISO/IEC 9899:2024):
- 7.21.7.3 Die Funktion fputc (S. TBD)
- 7.21.7.7 Die Funktion putc (S. TBD)
- C17-Standard (ISO/IEC 9899:2018):
- 7.21.7.3 Die Funktion fputc (S. TBD)
- 7.21.7.7 Die Funktion putc (S. TBD)
- C11-Standard (ISO/IEC 9899:2011):
- 7.21.7.3 Die Funktion fputc (S. 331)
- 7.21.7.7 Die Funktion putc (S. 333)
- C99-Standard (ISO/IEC 9899:1999):
- 7.19.7.3 Die Funktion fputc (S. 297)
- 7.19.7.8 Die Funktion putc (S. 299)
- C89/C90-Standard (ISO/IEC 9899:1990):
- 4.9.7.3 Die Funktion fputc
- 4.9.7.8 Die Funktion putc
Siehe auch
| schreibt ein Zeichen in stdout (Funktion) | |
C++-Dokumentation für fputc, putc
| |