Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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::hex

std::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.

Sources