Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::to_string — konwersja liczby na tekst

std::to_string z nagłówka <string> zwraca tekstową reprezentację liczby jako std::string. Wpis opisuje C++23, w tym ograniczenia formatowania liczb zmiennoprzecinkowych i różnicę względem nowszego szkicu standardu.

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

Składnia

#include <string>

std::string std::to_string(int val);
std::string std::to_string(unsigned val);
std::string std::to_string(long val);
std::string std::to_string(unsigned long val);
std::string std::to_string(long long val);
std::string std::to_string(unsigned long long val);
std::string std::to_string(float val);
std::string std::to_string(double val);
std::string std::to_string(long double val);

std::to_string(value) tworzy i zwraca std::string zawierający zapis liczby. Wymaga nagłówka <string>; nie wypisuje niczego samodzielnie. Przeciążenia przyjmują int, unsigned, long, unsigned long, long long, unsigned long long, float, double oraz long double. Liczby całkowite są zapisywane dziesiętnie, ze znakiem - dla wartości ujemnych.

W C++23 konwersja działa jak odpowiednie formatowanie przez sprintf. Dla skończonych wartości zmiennoprzecinkowych stosuje zapis stałopozycyjny z sześcioma cyframi po separatorze dziesiętnym. Separator zależy od globalnych ustawień regionalnych C. Małe wartości mogą zostać zaokrąglone do zera. W ustawieniach regionalnych "C" wywołanie std::to_string(1e-7) może dać "0.000000" przy zaokrąglaniu do najbliższej wartości. Jeśli sprintf uwzględnia aktywny tryb zaokrąglania, zaokrąglanie w górę może zamiast tego dać "0.000001". Nie traktuj tej funkcji jako bezstratnego zapisu dowolnej liczby zmiennoprzecinkowej.

Funkcja nie przyjmuje argumentów określających podstawę ani precyzję. Zwrócony tekst można łączyć z innym std::string, jak w przykładzie. To konwersja liczby na tekst, nie parsowanie tekstu na liczbę.

Zakres wersji: wpis dotyczy C++23, zgodnie z flagą kompilatora repozytorium; środowisko produkcyjne nie zostało potwierdzone. Bieżący szkic pod podanymi adresami opisuje już wynik jako format("{}", val) i wskazuje zmianę wyników zmiennoprzecinkowych względem C++23. Nie przenoś tego nowszego zachowania na C++23.

Przykłady

#include <iostream>
#include <string>

int main() {
    const std::string message = std::string("count=") + std::to_string(-42);
    std::cout << message << '\n';
}

Wynik

count=-42

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

Źródła