Funktionen vsnprintf () i C ++ används för att skriva en formaterad sträng till en strängbuffert.
Till skillnad från vsprintf () anges det maximala antalet tecken som kan skrivas till bufferten i vsnprintf().
vsnprintf () prototyp
int vsnprintf (char * buffert, size_t buf_size, const char * format, va_list vlist);
Den vsnprintf()funktionen skriver strängen utpekas av format till en teckensträng buffert. Det maximala antalet tecken som kan skrivas är buf_size. Efter att tecknen har skrivits läggs ett avslutande nulltecken till. Om buf_size är lika med noll skrivs ingenting och buffert kan vara en nollpekare.
Strängformatet kan innehålla formatspecifikationer som börjar med% som ersätts av värdena på variabler som skickas som en lista vlist.
Det definieras i rubrikfilen.
vsnprintf () Parametrar
- buffert: pekare till en teckensträng för att skriva resultatet.
- buf_size: Maximalt antal tecken att skriva.
- format: Pekare till en null-avslutad sträng som skrivs till filströmmen. Den består av tecken tillsammans med valfria formatspecifikationer som börjar med%.
Formatspecifikationerna ersätts av värdena för respektive variabler som följer formatsträngen.
Formatspecifikatorn har följande delar:
- Ett ledande% -tecken
- Flaggor: Valfri en eller flera flaggor som ändrar konverteringsbeteendet.
- -: Vänster motivera resultatet inom fältet. Som standard är det rätt motiverat.
- +: Tecknet på resultatet är fäst vid början av värdet, även för positiva resultat.
- Mellanslag: Om det inte finns något tecken, fästs ett mellanslag till början av resultatet.
- #: En alternativ form för konvertering utförs.
- 0: Det används för heltal och flytande nummer. Ledande nollor används för att lägga in siffrorna istället för mellanslag.
- Bredd: Ett valfritt * eller heltal som används för att ange minsta breddfält.
- Precision: Ett valfritt fält som består av en. följt av * eller heltal eller ingenting för att specificera precisionen.
- Längd: En valfri längdmodifierare som anger argumentets storlek.
- Specifier: En konverteringsformatspecifikator. De tillgängliga formatspecifikationerna är följande:
Format Specifier Beskrivning % Skriver ut% c Skriver en enda karaktär s Skriver en teckensträng d eller i Konverterar ett signerat heltal till decimalrepresentation o Konverterar ett osignerat heltal till oktalrepresentation X eller x Konverterar ett osignerat heltal till hexadecimal representation u Konverterar ett osignerat heltal till decimalrepresentation F eller f Konverterar flyttalsnummer till decimalrepresentationen E eller e Konverterar flytande nummer till decimal exponentnotation A eller a Konverterar flyttal till hexadecimalt exponent G eller g Konverterar flytpunktsnummer till antingen decimal- eller decimaleksponentnotation n Återställer antalet tecken som hittills har skrivits av detta samtal till funktionen. Resultatet skrivs till det värde som argumentet pekar på sid Skriver en implementeringsdefinierad teckenföljd som definierar en pekare. Så det allmänna formatet för formatspecifikatorn är:
%(flags)(width)(.precision)(length)specifier
- vlist: En lista med argument som innehåller de data som ska skrivas.
vsnprintf () Returvärde
- Om det lyckas
vsnprintf()returnerar funktionen antalet skrivna tecken. - Vid fel returnerar det ett negativt värde.
- När längden på den formaterade strängen är större än buf_size måste den trunkeras. I sådana fall
vsnprintf()returnerar funktionen det totala antalet tecken exklusive det avslutande nollkaraktären som skulle ha skrivits om gränsen för buf_size inte infördes.
Exempel: Hur vsnprintf () fungerar
#include #include void write(char* buf, int buf_size, const char *fmt,… ) ( va_list args; va_start(args, fmt); vsnprintf(buf, buf_size, fmt, args); va_end(args); ) int main () ( char buffer(100); char fname(20) = "Bjarne"; char lname(20) = "Stroustrup"; char lang(5) = "C++"; write(buffer, 27, "%s was created by %s %s", lang, fname, lname); printf("%s", buffer); return 0; )
När du kör programmet blir resultatet:
C ++ skapades av Bjarne
