Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::vformat — formatowanie z tekstem formatu ustalanym w czasie wykonania

std::vformat z nagłówka <format> tworzy napis na podstawie tekstu formatu i pakietu argumentów std::format_args. Pozwala użyć wzorca ustalanego w czasie wykonania; błędy wzorca względem argumentów zgłasza jako std::format_error.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#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 zwraca nowy napis, zamiast wypisywać go do strumienia. Przyjmuje tekst formatu oraz pakiet argumentów z wymazanymi typami. Wariant z std::string_view zwraca std::string; wariant z std::wstring_view używa std::wformat_args i zwraca std::wstring. Przeciążenia z std::locale obsługują formatowanie zależne od ustawień regionalnych.

W C++23 std::format standardowo sprawdza tekst formatu podczas kompilacji. std::vformat przyjmuje natomiast wzorzec dostępny dopiero w czasie wykonania. Błędna składnia, brak wskazanego argumentu lub specyfikator niezgodny z jego typem powodują std::format_error. Wyjątki z formatterów i błędy alokacji także mogą opuścić wywołanie.

Pakiet twórz przez std::make_format_args z nazwanych zmiennych. Nie traktuj go jak właściciela wszystkich wartości: może przechowywać odwołania do danych argumentów. Dane muszą pozostać ważne do końca formatowania, a samo std::format_args nie przedłuża życia magazynu utworzonego przez std::make_format_args. Przekazanie tego magazynu bezpośrednio do wywołania, jak w przykładzie, unika jego przedwczesnego zniszczenia.

W przykładzie {} wstawia label, a {:04d} zapisuje count dziesiętnie z minimalną szerokością czterech znaków i zerami z lewej strony. Wynik to item: 0007 i znak nowego wiersza. Wpis dotyczy C++23; podany odsyłacz prowadzi do rozwijanego projektu standardu, który może zawierać późniejsze zmiany. Flaga kompilatora w repozytorium nie potwierdza dostępności biblioteki w środowisku produkcyjnym.

Przykłady

#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';
}

Wynik

item: 0007

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła