C-Bibliotheksfunktionen -snprintf()

C-Standardbibliothek - <stdio.h>

Beschreibung

snprintf() ist eine Standardbibliotheksfunktion der Sprache C, die zum Formatieren und Ausgeben einer Zeichenkette verwendet wird und das Ergebnis in einen angegebenen Puffer schreibt. Im Gegensatz zu sprintf() begrenzt snprintf() die Anzahl der ausgegebenen Zeichen, um einen Pufferüberlauf zu vermeiden.

undsprintf()Der Unterschied besteht darin, dass die Funktion snprintf() einen Parameter, size, bereitstellt, der einen Pufferüberlauf verhindern kann. Wenn die Länge der formatierten Zeichenkette size-1 überschreitet, schreibt snprintf() nur size-1 Zeichen und fügt am Ende der Zeichenkette ein Nullzeichen (\0) hinzu, um deren Abschluss zu markieren.

Deklaration

Nachfolgend finden Sie die Deklaration der Funktion snprintf().

int snprintf ( char * str, size_t size, const char * format, ... );

int snprintf(char *str, size_t size, const char *format, ...)Die variablen Argumente werden(...)gemäßformatin eine Zeichenkette formatiert und die Zeichenkette nachstr kopiertDabei istsizedie maximale Anzahl der zu schreibenden Zeichen; wenn siesizeüberschreitet, wird sie abgeschnitten, und es werden höchstens size-1 Zeichen geschrieben.

Parameter

  • str-- Die Zielzeichenkette, ein Zeiger auf ein Zeichenarray, das zum Speichern der formatierten Zeichenkette verwendet wird.
  • size-- die Größe des Zeichenarrays.
  • format-- die Formatzeichenkette.
  • ...-- Variadische Argumente, eine variable Anzahl von Argumenten, die gemäß den Formatierungsanweisungen in format formatiert werden.

Rückgabewert

Der Rückgabewert ist eine Ganzzahl:

  • Bei Erfolg wird die Anzahl der Zeichen zurückgegeben, die geschrieben worden wären (ohne das abschließende Nullzeichen), selbst wenn dieser Wert größer als size ist.

  • Wenn ein Kodierungsfehler auftritt, wird ein negativer Wert zurückgegeben.

Beispiel

Das folgende Beispiel demonstriert die Verwendung der Funktion snprintf().

Beispiel

#include <stdio.h>
 
int main()
{
    char buffer[50];
    char* s = "examplecom";
 
    // Die Zeichenkette lesen und in buffer speichern.
    int j = snprintf(buffer, 6, "%s\n", s);
 
    // Ausgabepuffer und Zeichenanzahl.
    printf("Zeichenkette:\n%s\nZeichenanzahl = %d\n", buffer, j);
 
    return 0;
}

Das Ausgabeergebnis ist:

string:
runoo
character count = 10

Hier ist ein Beispiel, das zeigt, wie man%fDer Formatbezeichner für die Ausgabe einer Gleitkommazahl mit einfacher Genauigkeit in snprintf():

Beispiel

#include <stdio.h>

int main() {
  char buffer[50];
  float x = 3.1415926;
  int len = snprintf(buffer, 50, "x = %f", x);
  printf("%s\n", Puffer);
  printf("Geschriebene Zeichen: %d\n", len);
  return 0;
}

Das Ausgabeergebnis ist:

x = 3.141593
Written characters: 12

Im obigen Beispiel schreibt snprintf() die Zeichenkette "x = 3.141593" in den Puffer und gibt die Länge der Zeichenkette zurück, die 12 beträgt. Da die Größe des Puffers 50 beträgt, befindet sich am Ende der Zeichenkette ein Nullzeichen. Schließlich gibt das Programm die Zeichenkette im Puffer und die Anzahl der von snprintf() zurückgegebenen Zeichen aus.

Notizen:

  • Puffergröße:snprintf()Die Funktion begrenzt die Anzahl der ausgegebenen Zeichen, aber Sie müssen sicherstellen, dass die Größe des übergebenen Puffers groß genug ist, um die formatierte Zeichenkette aufzunehmen. Andernfalls kann die Zeichenkette abgeschnitten werden, was zu Informationsverlust führt.

  • Zeichenketten-Terminator:snprintf()Die Funktion fügt am Ende des Puffers ein Nullzeichen als Zeichenkettenabschluss hinzu, aber dieses Zeichen wird nicht im Rückgabewert gezählt. Wenn Sie dahersnprintf()Wenn Sie eine Zeichenkette ausgeben, müssen Sie sicherstellen, dass die Puffergröße ausreicht, um alle Zeichen der Zeichenkette sowie das abschließende Nullzeichen aufzunehmen.

  • Formatzeichenkette: Wenn Siesnprintf()Wenn Sie eine Zeichenkette formatieren, müssen Sie sicherstellen, dass die Formatbezeichner in der Formatzeichenkette mit den Typen der variablen Argumente übereinstimmen. Andernfalls kann das Ausgabeergebnis Fehler enthalten.

  • Rückgabewert:snprintf()Der Rückgabewert der Funktion ist die Anzahl der in den Puffer geschriebenen Zeichen, ohne das Nullzeichen am Ende der Zeichenkette. Wenn der Rückgabewert gleich der Größe des Puffers ist, deutet dies darauf hin, dass das Ausgabeergebnis abgeschnitten wurde.

  • Variable Argumente:snprintf()Die variablen Argumente der Funktion werden übergeben über...Das bedeutet, dass variable Argumente mit Typen übergeben werden müssen, die den Formatbezeichnern entsprechen. Bei der Verwendung variabler Argumente sollten Sie nicht initialisierte Variablen vermeiden; andernfalls können unvorhersehbare Ergebnisse auftreten.

Zusammenfassend müssen Sie bei der Verwendung der Funktion snprintf() auf Aspekte wie Puffergröße, String-Terminator, Formatzeichenfolge, Rückgabewert und variable Argumente achten, um sicherzustellen, dass das Ausgabeergebnis korrekt ist.

C-Standardbibliothek - <stdio.h>

Weitere Erweiterungen