
Blloku i funksioneve STR_FORMAT kthen një varg karakteresh të formatuara.
Ky bllok funksionës përgjigjet funksionit sprintf në C++.
Shënim: Ky bllok funksionës mund të ketë më shumë se dy hyrje. Ju mund të klikoni me tastin e djathtë të mouse-it mbi bllokin e funksioneve për të shtuar një hyrje tjetër.
Hyrja përcakton formatimin. Ky përbëhet nga një ose më shumë udhëzime: Karaktere normale (përveç %), që kopjohen drejtpërdrejt në rezultat dhe udhëzime për konvertim, të cilat kërkojnë secila parametrat e tyre.
Udhëzimi për konvertim ndjek prototipin:
%[ArgNum$][Flags][Weite][.Präzision]Spezifizierer.
Një numër i plotë i ndjekur nga një simbol dollar $, që përcakton numrin e hyrjes STR# që duhet të përdoret për konvertimin.
| Flag | Përshkrim |
|---|---|
| - | Lëviz në majtë brenda gjerësisë së caktuar të fushës; Lëvizja në djathtë është standarde. |
| + | Numrat pozitivë me një simbol plus +; Standarde, vetëm numrat negativë shfaqen me simbole negative. |
| (Hapësirë) | Mbush rezultatin me hapësira. Kjo është standarde. |
| 0 | Mbush në majtë me zero. Me specifikatorin s, kjo mund të mbush edhe në djathtë me zero. |
| '(Karakter) | Mbush rezultatin me karakterin e caktuar. |
Një numër i plotë që tregon sa karaktere (minimum) duhet të ketë rezultati i konvertimit.
Kuptimi i një pike . e ndjekur nga një numër i plotë varet nga specifikatori:
Shënim: Nëse pika shfaqet pa një vlerë eksplicite për saktësi, merr vlerën 0.
| Specifikatori | Përshkrim |
|---|---|
| % | Një simbol përqindje. Asnjë parametër nuk është i nevojshëm. |
| b | Parametri trajtohet si një numër i plotë dhe shfaqet si një numër binar. |
| c | Parametri trajtohet si një numër i plotë dhe shfaqet si një karakter nga seti ASCII. |
| d | Parametri trajtohet si një numër i plotë dhe shfaqet si një numër dhjetor me shenjë. |
| e | Parametri trajtohet si një numër në shkrim shkencor (p.sh. 1.2e+2). Specifikimi i saktësisë tregon numrin e karaktereve pas pikes së dhjetës. |
| E | Si specifikatori e, por shkruan një shkronjë të madhe (p.sh. 1.2E+2). |
| f | Parametri trajtohet si një numër me pikë të lëvizshme dhe shfaqet si një numër me pikë të lëvizshme (varësisht nga lokalizimi). |
| F | Parametri trajtohet si një numër me pikë të lëvizshme dhe shfaqet si një numër me pikë të lëvizshme (pavarësisht nga lokalizimi). |
| g | Format i përgjithshëm. Le P të jetë saktësia, nëse jo zero, 6 nëse saktësia nuk është e caktuar ose 1 nëse saktësia është zero. Pastaj, nëse një konvertim përmes E do të kishte një eksponent X: Nëse P > X ≥ -4, konvertimi bëhet me specifikatorin f dhe saktësi P - (X + 1). Nëse jo, si me specifikatorin e dhe saktësi P - 1. |
| G | Si specifikatori g, por përdor E dhe F. |
| o | Parametri trajtohet si një numër i plotë dhe shfaqet si një numër oktal. |
| s | Parametri trajtohet si një varg karakteresh dhe shfaqet. |
| u | Parametri trajtohet si një numër i plotë dhe shfaqet si një numër dhjetor pa shenjë. |
| x | Parametri trajtohet si një numër i plotë dhe shfaqet si një numër heksadecimal (me shkronja të vogla). |
| X | Parametri trajtohet si një numër i plotë dhe shfaqet si një numër heksadecimal (me shkronja të mëdha). |
Kuptim: Specifikatori c ignorohet mbushjen dhe gjerësinë.
Parandalim: Përpjekja për të përdorur kombinimin e vargjeve karakteresh me specifikatorët e gjerësisë dhe setet e karaktereve që priten më shumë se një byte për karakter çon në rezultate të papritura.
Variablat konvertohen në një tip të përshtatshëm për specifikatorin:
| Tipi | Specifikatori |
|---|---|
| Vargu i karaktereve | s |
| Integer | d, u, c, o, x, X, b |
| Float | g, G, e, E, f, F |
Hyrja ose hyrjet e shumta përcaktojnë vlerën e caktuar për zëvendësimin në vargun e karaktereve të caktuar në hyrjen FORMAT.
Kthen vargun e karaktereve të generuara.