Die Funktionen printf(), sprintf(), fprintf()
|
Die Funktionen printf(), sprintf()
und fprintf() sind eng miteinander verwandt
und werden daher gemeinsam vorgestellt.
Alle modernen Programmiersprachen
(z.B. → Perl,
→ PHP) bieten
diese Funktionen, allerdings in etwas abweichenden Varianten.
|
Alle genannten Funktionen sind in der Standard-Bibliothek
<stdio.h> enthalten und dienen der Erzeugung bzw. Ausgabe von
Strings (Text) aus fixen und variablen Bestandteilen.
Die gleichen Formatierungs-Regeln werden auch von den
Funktionen scanf() und
sscanf() verwendet.
|
Funktion printf()
Diese Funktion leitet den erzeugten String direkt an den Standard
Ausgabe-Kanal [stdout],
d.h. in den meisten Fällen zur Anzeige an das Konsolen-Fenster.
|
Funktion sprintf()
Diese Funktion übergibt den erzeugten String zur weiteren
Bearbeitung an eine String-Variable (Array bzw. Pointer vom
Typ char).
|
Syntax von printf()
int printf (const char *format [, Variablen-Liste]);
Rückgabe (optional, ganze Zahl)
•
Bei Erfolg die Anzahl >=0 der ausgegebenen Zeichen (String-Länge),
•
bei Misserfolg eine negative ganze Zahl <0
In der Praxis wird die Rückgabe meistens ignoriert.
1. Argument format (Format-String-Konstante)
Ein obligatorischer String zur Beschreibung des Ausgabe-Formats in einer Art
Mini-Programm.
Die komplexen Regeln werden in den weiteren ↓ Kapiteln vorgestellt.
2.... Argumente (Variablen-Liste)
Optionale Liste von Variablen, deren aktuelle Werte im Ausgabe-String
erscheinen sollen. Die einzelnen Variablen werden
durch , Beistrich getrennt.
•
Die Liste muss genauso viele Variable enthalten, wie Platzhalter im
Format-String enthalten sind.
|
Syntax von sprintf()
int sprintf (char *str, const char *format [,Variablen-Liste]);
Rückgabe (optional, ganze Zahl)
•
Bei Erfolg die Anzahl >=0 der ausgegebenen Zeichen (String-Länge),
und zwar ohne das abschließende 0-Byte,
•
bei Misserfolg eine negative ganze Zahl <0
1. Argument str (Rückgabe-String)
Pointer auf ein Array von Typ char, welches groß
genug ist, um den erzeugten String + 1 Null-Byte aufzunehmen.
2. Argument format (Format-String-Konstante)
Ein obligatorischer String zur Beschreibung des Ausgabe-Formats in
einer Art Mini-Programm.
Die komplexen ↓ Regeln sind identiasch mit jenen für die
Funktion printf()
3.... Argumente (Variablen-Liste)
Optionale Liste von Variablen, deren aktuelle Werte im Ausgabe-String
erscheinen sollen. Die einzelnen Variablen werden
durch , Beistrich getrennt.
•
Die Liste muss genauso viele Variable enthalten, wie Platzhalter im
Format-String enthalten sind.
|
Variablen-Liste
Die nach dem Format-String erwartete Liste der Variablen muss normale
Variable enthalten, d.h. Pointer sind nicht zulässig.
|
Ausnahmen stellen die beiden
↓ Typen %s (String) und
%p (Pointer) dar, bei denen nur Pointer erlaubt sind.
Die Type %n (Zeichen-Anzahl) braucht keine Variable.
|
|
Beispiel:
#include <stdio.h>
#include <string.h>
int main() {
int i,*pi;
double x;
char c,str[20];
printf("String-Konstante\n");
i = 123;
printf("i = %d (decimal)\n",i);
printf("i = 0%o (octal)\n",i);
printf("i = 0x%X (hexadecimal)\n",i);
x = 5000.0 / 3.0;
printf("x = %G (var)\n",x);
printf("x = %f (float)\n",x);
printf("x = %E (sci)\n",x);
c = 65;
printf("Code(%c) = %d\n",c,c);
strcpy(str,"ABC");
printf("str = %s\n",str);
pi = &i;
printf("pi = %p\n",pi);
}
Typische Ausgabe:
String-Konstante
i = 123 (decimal)
i = 0173 (octal)
i = 0x7B (hexadecimal)
x = 1666.67 (var)
x = 1666.666667 (float)
x = 1.666667E+003 (sci)
Code(A) = 65
str = ABC
pi = 012369CF
|
Beispiel:
#include <stdio.h>
#include <string.h>
int main() {
int i;
double x;
char c,s1[31],s2[31],s3[255];
strcpy(s3,"String-Konstante\n");
i = 234;
sprintf(s1,"i=%d\n",i);
strcat(s3,s1);
x = 5.0 / 3.0;
sprintf(s1,"x=%f\n",x);
strcat(s3,s1);
c = 90;
sprintf(s1,"Zeichen(%d) = %c\n",c);
strcat(s3,s1);
strcpy(s2,"XYZ");
sprintf(s1,"s2 = %s\n",s2);
strcat(s3,s1);
printf("%s",s3);
}
Ausgabe:
String-Konstante
i = 234
x = 1.666667
Zeichen(90) = Z
s2 = XYZ
Die Teile (Zeilen) des Test-Strings werden in s1, s2
erzeugt, in s3 gesammelt und zuletzt ausgegeben.
|
•
Hinweis zu den Beispielen:
Die beiden Funktionen strcpy()
und strcat() sind in der Standard
C-Bibliothek <string.h> enthalten.
|
•
Funktion strcpy() fügt das 2. Argument
als 0-terminierten String in die als 1. Argument bezeichnete
String-Variable ein.
•
Funktion strcat() verkettet die beiden
als Argumente bezeichneten Strings und fügt sie als
0-terminierten String in das 1. Argument ein.
|
Funktion fprintf()
Diese Funktion dient zur Ausgabe an Dateien. Sie erhält als
zusätzliches Argument das FileHandle (hier fp) und
arbeitet ansonsten gleich wie printf()
|
Beispiel:
FILE *fp;
char path[]="/srv/www/htdocs/c_to_web_2.html";
fp = fopen(path,"w");
fprintf(fp,"Ausgabe an Datei %s\n",path);
fclose(fp);
|
C/C++
Das bietet die Möglichkeit, die Ausgabe von Konsolen-Programmen übersichtlicher
zu gestalten.
Wenig erfahrere EntwicklerInnen neigen dazu, die Rundung in Ausgabe-Funktionen mit der
Rundung der Werte von Gleitkomma-Zahlen zu verwechseln. Die beiden Begriffe sind voneinander
unabhängig !
Die Anzahl und Formatierung der Stellen ist von System und Compiler vorgegeben.