CKTIS / C++
std::chars_format — format de conversion des nombres à virgule flottante
std::chars_format choisit la notation des nombres à virgule flottante pour std::to_chars et les règles de lecture pour std::from_chars. Il propose les formats general, fixed, scientific et hex ; il ne définit pas lui-même la précision.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <charconv>
std::chars_format::general
std::chars_format::fixed
std::chars_format::scientific
std::chars_format::hexstd::chars_format, déclaré dans <charconv>, est une énumération à portée et un type masque de bits utilisé par les surcharges à virgule flottante de std::to_chars et std::from_chars. Les valeurs numériques de scientific, fixed et hex ne sont pas spécifiées ; general équivaut à fixed | scientific. Pour une conversion, passez l’une des valeurs nommées, et non une combinaison arbitraire de bits.
En sortie, std::chars_format::fixed sélectionne la notation décimale sans exposant, tandis que std::chars_format::scientific sélectionne la notation décimale avec exposant. std::chars_format::general choisit entre ces formes. std::chars_format::hex sélectionne la notation hexadécimale avec un exposant de puissance de deux marqué par p, sans préfixe 0x.
La précision est un argument distinct de std::to_chars : pour fixed et scientific, elle indique le nombre de chiffres après le séparateur décimal ; pour general, elle indique la précision en chiffres significatifs. Ne l’interprétez pas comme le nombre de décimales dans tous les formats. La fonction n’ajoute pas de caractère nul final ; vérifiez ec et utilisez la plage qui se termine à ptr.
Pour la lecture avec std::from_chars, scientific exige un exposant, fixed en interdit un, et le format par défaut general accepte les deux formes. Le format hex ne consomme pas de préfixe 0x : avec 0x123, il peut lire correctement uniquement 0, en laissant x123. Si toute l’entrée doit être consommée, vérifiez à la fois ec et ptr == last.
Exemples
#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';
}
}
Résultat
12.500 1.250e+01 12.5
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.