CKTIS / C++
std::to_string — een getal omzetten naar tekst
std::to_string uit <string> geeft de tekstuele weergave van een getal terug als std::string. Dit artikel behandelt C++23, inclusief beperkingen van de drijvendekommaopmaak en het verschil met het nieuwere werkdocument.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#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) maakt een std::string met de weergave van een getal en geeft die terug. De functie vereist <string> en voert zelf niets uit. De overloads accepteren int, unsigned, long, unsigned long, long long, unsigned long long, float, double en long double. Gehele getallen worden decimaal geschreven, met een - voor negatieve waarden.
In C++23 gedraagt de conversie zich als de overeenkomstige opmaak met sprintf. Eindige drijvendekommagetallen gebruiken de vaste notatie, met zes cijfers na het decimaalteken. Het decimaalteken hangt af van de globale C-locale. Kleine waarden kunnen naar nul worden afgerond. In de "C"-locale kan std::to_string(1e-7) bij afronding naar de dichtstbijzijnde waarde "0.000000" opleveren. Als sprintf rekening houdt met de actieve afrondingsmodus, kan afronding naar boven in plaats daarvan "0.000001" opleveren. Beschouw deze functie niet als een verliesloze weergave van willekeurige drijvendekommagetallen.
De functie accepteert geen argumenten om een grondtal of precisie te kiezen. Je kunt de teruggegeven tekst, zoals in het voorbeeld, samenvoegen met een andere std::string. De functie zet een getal om in tekst; ze parseert geen tekst naar een getal.
Versiebereik: dit artikel richt zich op C++23, overeenkomstig de compileroptie van de repository; het gedrag in de productieomgeving is niet bevestigd. Het huidige werkdocument op de opgegeven adressen schrijft het resultaat al voor als format("{}", val) en vermeldt gewijzigde drijvendekommaresultaten ten opzichte van C++23. Pas dat nieuwere gedrag niet toe op C++23.
Voorbeelden
#include <iostream>
#include <string>
int main() {
const std::string message = std::string("count=") + std::to_string(-42);
std::cout << message << '\n';
}
Resultaat
count=-42
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.