CKTIS / C++
std::vformat — oblikovanje z nizom za oblikovanje, določenim med izvajanjem
std::vformat iz <format> ustvari niz iz niza za oblikovanje in paketa argumentov std::format_args. Sprejme vzorec, določen med izvajanjem, in neveljavno oblikovanje za podane argumente sporoči z std::format_error.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <format>
std::string std::vformat(std::string_view fmt, std::format_args args);
std::wstring std::vformat(std::wstring_view fmt, std::wformat_args args);
std::string std::vformat(const std::locale& loc, std::string_view fmt, std::format_args args);
std::wstring std::vformat(const std::locale& loc, std::wstring_view fmt, std::wformat_args args);std::vformat vrne nov niz, namesto da bi pisal v tok. Sprejme niz za oblikovanje in paket argumentov z izbrisanimi tipi. Preobremenitev s std::string_view vrne std::string; preobremenitev s std::wstring_view uporablja std::wformat_args in vrne std::wstring. Preobremenitve, ki sprejmejo std::locale, podpirajo oblikovanje glede na krajevne nastavitve.
V C++23 std::format običajno preveri niz za oblikovanje med prevajanjem. Nasprotno std::vformat sprejme vzorec, ki je na voljo šele med izvajanjem. Neveljavna sintaksa, manjkajoč navedeni argument ali določilo, nezdružljivo s tipom argumenta, povzroči std::format_error. Iz klica lahko uidejo tudi izjeme oblikovalnikov in napake pri dodeljevanju pomnilnika.
Paket ustvarite z std::make_format_args in poimenovanimi spremenljivkami. Ne obravnavajte ga, kot da bi bil lastnik vseh vrednosti: hrani lahko sklice na podatke argumentov. Ti podatki morajo ostati veljavni do konca oblikovanja, sam std::format_args pa ne podaljša življenjske dobe shrambe, ki jo ustvari std::make_format_args. Neposredna predaja te shrambe klicu, kot v primeru, prepreči njeno prezgodnje uničenje.
V primeru {} vstavi label, medtem ko {:04d} zapiše count v desetiški obliki z najmanjšo širino štirih znakov in ničlami na začetku. Izhod je item: 0007, ki mu sledi znak za novo vrstico. Ta vnos obravnava C++23; navedena referenca vodi do razvijajočega se delovnega osnutka, ki lahko vsebuje poznejše spremembe. Zastavica prevajalnika v repozitoriju ne dokazuje, da je knjižnica na voljo v produkcijskem okolju.
Primeri
#include <format>
#include <iostream>
#include <string>
int main() {
std::string pattern = "{}: {:04d}";
std::string label = "item";
int count = 7;
std::string result = std::vformat(
pattern, std::make_format_args(label, count));
std::cout << result << '\n';
}
Rezultat
item: 0007
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.