KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

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

Bronnen