Funktionen vswprintf () i C ++ används för att skriva en formaterad bred sträng till en bred strängbuffert.
Funktionen vswprintf () definieras i rubrikfilen.
vswprintf () prototyp
int vswprintf (wchar_t * buffert, storlek_t buf_size, const wchar_t * format, va_list vlist);
Funktionen vswprintf () skriver den breda strängen pekad på genom format till den breda strängbufferten. Maximalt (buf_size-1)breda tecken skrivs till buffert som följs av ett null brett tecken.
Det breda strängformatet kan innehålla formatspecifikationer som börjar med% som ersätts av värdena på variabler som skickas som en lista vlist.
vswprintf () Parametrar
- buffert: pekare till en bred strängbuffert för att skriva resultatet.
- buf_size: Maximalt antal breda tecken att skriva inklusive det avslutande null-breda tecknet.
- format: En pekare till en null-avslutad bred sträng som skrivs till buffert. 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 formatet.
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:% (flaggor) (bredd) (. precision) (längd) specificerare
- vlist: En lista med argument som innehåller de data som ska skrivas.
vswprintf () Returvärde
- Om det lyckas returnerar funktionen vswprintf () antalet breda tecken skrivna exklusive det avslutande null breda tecknet.
- Ett negativt värde returneras om något kodningsfel uppstår eller om antalet tecken som ska genereras var lika med eller större än buf_size.
Exempel: Hur fungerar vswprintf () -funktionen?
#include #include #include void write(wchar_t* buffer, size_t buf_size, const wchar_t *fmt,… ) ( va_list args; va_start(args, fmt); vswprintf(buffer, buf_size, fmt, args); va_end(args); ) int main () ( wchar_t str() = L"u0684 u06b1 u06aa u06a3 u0684"; wchar_t buffer(50); setlocale(LC_ALL, "en_US.UTF-8"); write(buffer, 50, L"Arabic Letters: %ls", str); wprintf(L"%ls", buffer); return 0; )
När du kör programmet kommer följande att skrivas till exempel.txt:
Arabiska bokstäver: ڄ ڱ ڪ ڣ ڄ
