Funkcia vsprintf () v C ++ sa používa na zápis formátovaného reťazca do vyrovnávacej pamäte reťazca.
vsprintf () prototyp
int vsprintf (char * buffer, const char * format, va_list vlist);
vsprintf()
Funkcia zapíše reťazec odkazuje formátu do znakového reťazca vyrovnávacej pamäte. Formát reťazca môže obsahovať špecifikátory formátu začínajúce na%, ktoré sú nahradené hodnotami premenných, ktoré sa odovzdávajú ako zoznam vlist.
Je definované v hlavičkovom súbore.
Parametre vsprintf ()
- buffer: Ukazovateľ na znakový reťazec, ktorým sa zapíše výsledok.
- formát: Ukazovateľ na reťazec s nulovým zakončením, ktorý sa zapíše do toku súborov. Skladá sa zo znakov spolu s voliteľnými špecifikátormi formátu začínajúcich na%.
Špecifikátory formátu sú nahradené hodnotami príslušných premenných, ktoré nasledujú za formátovacím reťazcom.
Špecifikátor formátu má tieto časti:
- Vedúci znak%
- Príznaky: Voliteľný jeden alebo viac príznakov, ktoré upravujú správanie pri konverzii.
- -: Zarovnanie doľava k výsledku v rámci poľa. Štandardne je to zarovnané doprava.
- +: Znamienko výsledku sa pripája na začiatok hodnoty, a to aj v prípade pozitívnych výsledkov.
- Medzera: Ak nie je žiadny znak, na začiatok výsledku sa pripojí medzera.
- #: Vykoná sa alternatívna forma konverzie.
- 0: Používa sa na celé číslo a číslo s pohyblivou rádovou čiarkou. Na vyplnenie čísel namiesto medzery sa používajú úvodné nuly.
- Šírka: Voliteľná * alebo celočíselná hodnota používaná na zadanie poľa minimálnej šírky.
- Presnosť: Nepovinné pole pozostávajúce z a. za ktorými nasleduje * alebo celé číslo alebo nič, aby sa určila presnosť.
- Dĺžka: Voliteľný modifikátor dĺžky, ktorý určuje veľkosť argumentu.
- Špecifikátor: Špecifikátor formátu prevodu. Dostupné špecifikátory formátu sú:
Špecifikátor formátu Popis % Vytlačí% c Píše jeden znak s Zapíše reťazec znakov d alebo i Skonvertuje celé číslo so znamienkom na desatinné miesto o Skonvertuje celé číslo bez znamienka na osmičkovú reprezentáciu X alebo x Skonvertuje celé číslo bez znamienka na hexadecimálne vyjadrenie u Skonvertuje celé číslo bez znamienka na desatinné miesto F alebo f Prevedie číslo s pohyblivou rádovou čiarkou na desatinné miesto E alebo e Skonvertuje číslo s pohyblivou desatinnou čiarkou na desatinný zápis exponentu A alebo a Prevedie číslo s pohyblivou rádovou čiarkou na hexadecimálny exponent G alebo g Prevedie číslo s pohyblivou rádovou čiarkou na desatinný alebo desatinný zápis exponentu n Vráti počet znakov doteraz napísaných týmto volaním funkcie. Výsledok sa zapíše na hodnotu, na ktorú poukazuje argument p Zapíše postupnosť znakov definujúcich implementáciu, ktorá definuje ukazovateľ. Všeobecný formát špecifikátora formátu je teda:
%(flags)(width)(.precision)(length)specifier
- vlist: Zoznam argumentov obsahujúcich údaje na zápis.
vsprintf () Vrátená hodnota
Ak je úspešná, vsprintf()
funkcia vráti počet napísaných znakov. Pri zlyhaní vráti zápornú hodnotu.
Príklad: Ako funguje funkcia vsprintf ()
#include #include void write(char* buf, const char *fmt,… ) ( va_list args; va_start(args, fmt); vsprintf(buf, fmt, args); va_end(args); ) int main () ( char buffer(100); char fname(20) = "Bjarne"; char lname(20) = "Stroustrup"; char lang(5) = "C++"; write(buffer, "%s was created by %s %s", lang, fname, lname); printf("%s", buffer); return 0; )
Po spustení programu bude výstup:
C ++ vytvoril Bjarne Stroustrup