CKTIS / C
vsprintf — Formatierung in einen Puffer mit va_list
vsprintf schreibt formatierten Text in einen Puffer und bezieht die Argumente aus einer va_list. Die Funktion erhält keine Puffergröße.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdarg.h>
#include <stdio.h>
int vsprintf(char * restrict s, const char * restrict format, va_list arg);vsprintf funktioniert wie sprintf, akzeptiert jedoch eine va_list statt Argumenten aus .... In s schreibt die Funktion außerdem ein abschließendes Nullzeichen.
Der Puffer muss das vollständige Ergebnis einschließlich des Nullzeichens aufnehmen können. Ein Überlauf und das Kopieren zwischen überlappenden Objekten führen zu undefiniertem Verhalten. Die Argumenttypen müssen zu den Formatspezifizierern passen. Verwende keine nicht vertrauenswürdigen Texte als format; wähle vsnprintf, um Schreibvorgänge zu begrenzen.
Initialisiere die Liste mit va_start. Die Funktion ruft va_end nicht auf: Das musst du selbst tun. Lies die Liste danach nicht erneut aus. Erstelle vor dem Aufruf mit va_copy eine Kopie, wenn du sie unabhängig durchlaufen möchtest.
Der Rückgabewert gibt die Anzahl der geschriebenen Zeichen ohne das abschließende Nullzeichen an oder ist bei einem Kodierungsfehler negativ.
Beispiele
#include <stdarg.h>
#include <stdio.h>
/* Only for calls whose complete output fits in dst. */
static int format_text(char *dst, const char *format, ...)
{
va_list args;
va_start(args, format);
int result = vsprintf(dst, format, args);
va_end(args);
return result;
}
int main(void)
{
char text[16];
int count = format_text(text, "score=%d", 7);
if (count < 0) {
return 1;
}
puts(text);
printf("%d\n", count);
return 0;
}
Ergebnis
score=7 7
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.