C library functionvfprintf()
C-Standardbibliothek - <stdio.h>
Beschreibung
C Library Functionsint vfprintf(FILE *stream, const char *format, va_list arg)Sendet formatierte Ausgabe unter Verwendung einer Argumentliste an den Stream.
Deklaration
Nachfolgend finden Sie die Deklaration der Funktion vfprintf().
int vfprintf(FILE *stream, const char *format, va_list arg)
Parameter
- stream-- Dies ist ein Zeiger auf ein FILE-Objekt, das den Stream identifiziert.
- format-- Dies ist eine C-Zeichenkette, die den in den Stream zu schreibenden Text enthält. Sie kann eingebettete Format-Tags enthalten, die durch die in nachfolgenden zusätzlichen Argumenten angegebenen Werte ersetzt und nach Bedarf formatiert werden. Die Attribute der Format-Tags sind: %[flags][width][.precision][length]specifier, die spezifische Erklärung lautet wie folgt:
| Formatbezeichner | Ausgabe |
|---|---|
| c | Zeichen |
| d oder i | vorzeichenbehaftete Dezimal-Ganzzahl |
| e | Wissenschaftliche Notation (Mantisse und Exponent) unter Verwendung des Zeichens e |
| E | Wissenschaftliche Notation (Mantisse und Exponent) unter Verwendung des Zeichens E |
| f | Dezimal-Gleitkommazahl |
| g | Automatische Auswahl der passenden Darstellung aus %e oder %f |
| G | Automatische Auswahl der passenden Darstellung aus %E oder %f |
| o | Oktalzahl mit Vorzeichen |
| s | Zeichenkette |
| u | vorzeichenlose Dezimal-Ganzzahl |
| x | vorzeichenlose Hexadezimal-Ganzzahl |
| X | Vorzeichenlose Hexadezimal-Ganzzahl (Großbuchstaben) |
| p | Zeigeradresse |
| n | Keine Ausgabe |
| % | Zeichen |
| Flags | Beschreibung |
|---|---|
| - | Linksbündig innerhalb der angegebenen Feldbreite ausrichten; Standard ist rechtsbündig (siehe Breiten-Teilspezifizierer). |
| + | Erzwingt, dass ein Plus- oder Minuszeichen (+ oder -) vor dem Ergebnis angezeigt wird, d. h. positive Zahlen zeigen ein +-Zeichen davor. Standardmäßig zeigen nur negative Zahlen ein -Zeichen davor. |
| (Leerzeichen) | Wenn kein Vorzeichen geschrieben wird, wird ein Leerzeichen vor den Wert eingefügt. |
| # | Bei Verwendung mit den Spezifizierern o, x oder X wird einem Wert ungleich Null 0, 0x bzw. 0X vorangestellt. Wenn es mit e, E und f verwendet wird, erzwingt es, dass die Ausgabe einen Dezimalpunkt enthält, selbst wenn keine Ziffern danach folgen. Standardmäßig wird der Dezimalpunkt nicht angezeigt, wenn keine Ziffern darauf folgen. Bei Verwendung mit g oder G ist das Ergebnis dasselbe wie bei Verwendung von e oder E, aber nachfolgende Nullen werden nicht entfernt. |
| 0 | Bei angegebenem Padding werden Nullen (0) links von der Zahl anstelle von Leerzeichen platziert (siehe Breiten-Teilspezifizierer). |
| width | Beschreibung |
|---|---|
| (Zahl) | Mindestanzahl der auszugebenden Zeichen. Wenn der Ausgabewert kürzer als diese Anzahl ist, wird das Ergebnis mit Leerzeichen aufgefüllt. Wenn der Ausgabewert länger als diese Anzahl ist, wird das Ergebnis nicht abgeschnitten. |
| * | Die Breite wird nicht im Formatstring angegeben, sondern als zusätzliches Ganzzahlwert-Argument vor dem zu formatierenden Argument platziert. |
| .precision | Beschreibung |
|---|---|
| .number | Für Ganzzahl-Spezifizierer (d, i, o, u, x, X): Die Präzision gibt die minimale Anzahl der zu schreibenden Ziffern an. Wenn der geschriebene Wert kürzer als diese Zahl ist, wird das Ergebnis mit führenden Nullen aufgefüllt. Wenn der geschriebene Wert länger als diese Zahl ist, wird das Ergebnis nicht abgeschnitten. Eine Präzision von 0 bedeutet, dass keine Zeichen geschrieben werden. Für die Spezifizierer e, E und f: die Anzahl der Ziffern, die nach dem Dezimalpunkt ausgegeben werden. Für die Spezifizierer g und G: die maximale Anzahl signifikanter Ziffern, die ausgegeben werden. Für s: die maximale Anzahl Zeichen, die ausgegeben werden. Standardmäßig werden alle Zeichen ausgegeben, bis das abschließende Nullzeichen angetroffen wird. Für den Typ c: hat keine Auswirkung. Wenn keine Genauigkeit angegeben wird, ist der Standardwert 1. Wenn sie ohne expliziten Wert angegeben wird, wird 0 angenommen. |
| .* | Die Genauigkeit wird nicht im Formatstring angegeben, sondern als zusätzliches Ganzzahlwert-Argument vor dem zu formatierenden Argument platziert. |
| length | Beschreibung |
|---|---|
| h | Das Argument wird als short int oder unsigned short int interpretiert (gilt nur für Ganzzahl-Formatbezeichner: i, d, o, u, x und X). |
| l | Das Argument wird als long int oder unsigned long int interpretiert, anwendbar auf Ganzzahl-Spezifizierer (i, d, o, u, x und X) sowie die Spezifizierer c (steht für ein Breitzeichen) und s (steht für eine Breitzeichen-Zeichenkette). |
| L | Das Argument wird als long double interpretiert (gilt nur für Gleitkomma-Formatbezeichner: e, E, f, g und G). |
- arg-- Ein Objekt, das die variable Argumentliste darstellt. Dieses sollte mit dem in <stdarg> definierten Makro va_start initialisiert werden.
Rückgabewert
Bei Erfolg wird die Gesamtzahl der geschriebenen Zeichen zurückgegeben; andernfalls wird eine negative Zahl zurückgegeben.
Beispiel
Das folgende Beispiel demonstriert die Verwendung der Funktion vfprintf().
#include <stdio.h>
#include <stdarg.h>
void WriteFrmtd(FILE *stream, char *format, ...)
{
va_list args;
va_start(args, format);
vfprintf(stream, format, args);
va_end(args);
}
int main ()
{
FILE *fp;
fp = fopen("file.txt","w");
WriteFrmtd(fp, "This is just one argument %d \n", 10);
fclose(fp);
return(0);
}
Lassen Sie uns das obige Programm kompilieren und ausführen, das die Datei im aktuellen Verzeichnisfile.txtöffnet und den folgenden Inhalt schreibt:
This is just one argument 10
Nun verwenden wir das folgende Programm, um den Inhalt der obigen Datei anzuzeigen:
#include <stdio.h>
int main ()
{
FILE *fp;
int c;
fp = fopen("file.txt","r");
while(1)
{
c = fgetc(fp);
if( feof(fp) )
{
break ;
}
printf("%c", c);
}
fclose(fp);
return(0);
}
Weitere Erweiterungen