CKTIS / C++
std::chars_format — conversieformaat voor drijvende-kommagetallen
std::chars_format kiest de notatie voor drijvende-kommagetallen van std::to_chars en de leesregels voor std::from_chars. Het biedt de formaten general, fixed, scientific en hex; het stelt de precisie niet zelf in.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <charconv>
std::chars_format::general
std::chars_format::fixed
std::chars_format::scientific
std::chars_format::hexstd::chars_format, gedeclareerd in <charconv>, is een scoped enumeratie en een bitmaskertype dat wordt gebruikt door de overloads voor drijvende-kommagetallen van std::to_chars en std::from_chars. De numerieke waarden van scientific, fixed en hex zijn niet gespecificeerd; general is gelijk aan fixed | scientific. Geef bij een conversie een van de benoemde waarden door, geen willekeurige combinatie van bits.
Voor uitvoer kiest std::chars_format::fixed de decimale notatie zonder exponent, terwijl std::chars_format::scientific de decimale notatie met exponent kiest. std::chars_format::general kiest tussen deze vormen. std::chars_format::hex kiest de hexadecimale notatie met een exponent voor een macht van twee, aangeduid met p, zonder 0x-voorvoegsel.
Precisie is een afzonderlijk argument van std::to_chars: bij fixed en scientific geeft het het aantal cijfers na het decimaalteken aan; bij general geeft het de precisie in significante cijfers aan. Zie het niet bij elk formaat als het aantal decimalen. De functie voegt geen afsluitende nulterminator toe; controleer ec en gebruik het bereik dat eindigt bij ptr.
Bij invoer via std::from_chars vereist scientific een exponent, staat fixed die niet toe en accepteert de standaardindeling general beide vormen. Het formaat hex verwerkt geen 0x-voorvoegsel: bij 0x123 kan het alleen 0 succesvol lezen en x123 laten staan. Als de volledige invoer moet worden verwerkt, controleer dan zowel ec als ptr == last.
Voorbeelden
#include <charconv>
#include <iostream>
#include <system_error>
int main() {
const std::chars_format formats[] = {
std::chars_format::fixed,
std::chars_format::scientific,
std::chars_format::general
};
for (auto fmt : formats) {
char buffer[64];
const auto result = std::to_chars(
buffer, buffer + sizeof buffer, 12.5, fmt, 3);
if (result.ec != std::errc{}) {
std::cerr << "conversion failed\n";
return 1;
}
std::cout.write(buffer, result.ptr - buffer);
std::cout << '\n';
}
}
Resultaat
12.500 1.250e+01 12.5
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.