A snprintf () függvény a C ++ - ban egy formázott karakterlánc írásához használható karakterlánc-pufferhez.
A sprintf () -tõl eltérõen a pufferbe írható karakterek maximális számát a snprintf()
.
snprintf () prototípus
int snprintf (char * puffer, size_t buf_size, const char * formátum,…);
A snprintf()
függvény a formátum szerint mutatott karakterláncot pufferbe írja. A karakterek maximális száma lehet írva (buf_size-1)
.
A karakterek írása után egy végződő null karakter kerül hozzáadásra. Ha a buf_size értéke nulla, akkor semmit nem írunk, és a puffer null mutató lehet.
A fejlécfájlban van meghatározva.
snprintf () Paraméterek
- puffer: Mutat a string pufferre az eredmény megírásához.
- buf_size: Adja meg a pufferbe írandó karakterek maximális számát, amely a buf_size-1.
- formátum: Mutató egy nullával végződő karakterláncra, amelyet a fájlfolyamba írnak. Karakterekből áll, és opcionális formátum-specifikátorokkal kezdődik, amelyek% -kal kezdődnek.
A formátum-specifikátorokat a megfelelő változók értékei helyettesítik, amelyek a formátum-karakterláncot követik.
A formátummeghatározó a következő részekkel rendelkezik:
- Vezető% jel
- Jelölések: Opcionálisan egy vagy több jelölés, amely módosítja a konverzió viselkedését.
- -: Bal igazolja az eredményt a mezőn belül. Alapértelmezés szerint helyesen indokolt.
- +: Az eredmény jele az érték elejéhez van kötve, még pozitív eredmények esetén is.
- Szóköz: Ha nincs előjel, akkor az eredmény elejéhez szóköz tartozik.
- #: A konverzió alternatív formáját hajtják végre.
- 0: Egész számra és lebegőpontos számra használják. A nullák a szóköz helyett a számok kitöltésére szolgálnak.
- Szélesség: Opcionális * vagy egész érték, amelyet a minimális szélesség mező megadásához használnak.
- Pontosság: Választható mező, amely a. * vagy egész szám, vagy semmi a pontosság megadásához.
- Hossz: Opcionális hosszmódosító, amely megadja az argumentum méretét.
- Specifier: Konverziós formátum-specifikáló. A rendelkezésre álló formátum-meghatározók a következők:
Formátummeghatározó Leírás % Nyomat% c Egyetlen karaktert ír s Karakterláncot ír d vagy i Az aláírt egész számot decimális ábrázolássá alakítja o Az előjel nélküli egész számot oktális ábrázolássá alakítja X vagy x Aláíratlan egész számot hexadecimális ábrázolássá alakítja u Az aláíratlan egész számot decimális ábrázolássá alakítja F vagy f A lebegőpontos számot tizedesre konvertálja E vagy e A lebegőpontos számot decimális exponens jelöléssé alakítja A vagy a A lebegőpontos számot hexadecimális kitevővé konvertálja G vagy g A lebegőpontos számot decimális vagy decimális exponens jelöléssé alakítja n Visszaadja a függvénynek a hívás által eddig írt karakterek számát. Az eredményt arra az értékre írják, amelyre az argumentum rámutat o Ír egy megvalósítás által definiált karaktersorozatot, amely meghatároz egy mutatót. Tehát a formátummeghatározó általános formátuma:
%(flags)(width)(.precision)(length)specifier
- …: Egyéb további érvek, amelyek meghatározzák a kinyomtatandó adatokat. A formátummeghatározó szerint sorrendben fordulnak elő.
snprintf () Visszatérési érték
Sikeres eredmény esetén a snprintf()
függvény olyan karakterek számát adja vissza, amelyeket elég nagy pufferhez írtak volna, kivéve a befejező null karaktert. Meghibásodás esetén negatív értéket ad vissza.
A kimenet akkor tekinthető teljesen írottnak, ha a visszaadott érték nem negatív és kisebb, mint a buf_size.
Példa: Hogyan működik az snprintf () függvény
#include #include using namespace std; int main() ( char buffer(100); int retVal, buf_size = 100; char name() = "Max"; int age = 23; retVal = snprintf(buffer, buf_size, "Hi, I am %s and I am %d years old", name, age); if (retVal> 0 && retVal < buf_size) ( cout << buffer << endl; cout << "Number of characters written = " << retVal << endl; ) else cout << "Error writing to buffer" << endl; return 0; )
A program futtatásakor a kimenet a következő lesz:
Szia, Max vagyok, és 23 éves vagyok. Írott karakterek száma = 34