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.