Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::to_string — převod čísla na text

std::to_string z hlavičky <string> vrací textovou reprezentaci čísla jako std::string. Tento záznam se týká C++23, včetně omezení formátování čísel s plovoucí desetinnou čárkou a rozdílu oproti novějšímu pracovnímu návrhu.

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

Syntaxe

#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) vytvoří a vrátí std::string obsahující zápis čísla. Vyžaduje <string> a sama nic nevypisuje. Její přetížení přijímají int, unsigned, long, unsigned long, long long, unsigned long long, float, double a long double. Celá čísla se zapisují desítkově, záporné hodnoty se znaménkem -.

V C++23 se převod chová jako odpovídající formátování pomocí sprintf. Konečné hodnoty s plovoucí desetinnou čárkou používají pevný formát se šesti číslicemi za desetinným oddělovačem. Oddělovač závisí na globálním prostředí C. Malé hodnoty se mohou zaokrouhlit na nulu. V prostředí "C" může std::to_string(1e-7) při zaokrouhlování na nejbližší hodnotu vrátit "0.000000". Pokud sprintf respektuje aktivní režim zaokrouhlování, může zaokrouhlení nahoru místo toho dát "0.000001". Nepovažujte tuto funkci za bezeztrátový zápis libovolných čísel s plovoucí desetinnou čárkou.

Funkce nepřijímá argumenty pro volbu základu ani přesnosti. Vrácený text lze spojit s jiným std::string, jak ukazuje příklad. Funkce převádí číslo na text; neparsuje text na číslo.

Rozsah verzí: tento záznam se vztahuje k C++23, v souladu s příznakem kompilátoru v repozitáři; chování v produkčním běhovém prostředí není potvrzeno. Aktuální návrh na uvedených adresách již určuje výsledek jako format("{}", val) a uvádí změněné výsledky čísel s plovoucí desetinnou čárkou oproti C++23. Toto novější chování na C++23 nevztahujte.

Příklady

#include <iostream>
#include <string>

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

Výsledek

count=-42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje