WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::chars_format — Format für Gleitkommakonvertierungen

std::chars_format wählt die Schreibweise von Gleitkommazahlen für std::to_chars und die Einleseregeln für std::from_chars. Es bietet die Formate general, fixed, scientific und hex; die Genauigkeit legt es nicht selbst fest.

Version: 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 aus dem Header <charconv> ist eine scoped Enumeration und ein Bitmaskentyp, der von den Gleitkommaüberladungen von std::to_chars und std::from_chars verwendet wird. Die numerischen Werte von scientific, fixed und hex sind nicht spezifiziert; general entspricht fixed | scientific. Übergib einer Konvertierung einen der benannten Werte, nicht eine beliebige Bitkombination.

Bei der Ausgabe wählt std::chars_format::fixed die Dezimalschreibweise ohne Exponent, während std::chars_format::scientific die Dezimalschreibweise mit Exponent wählt. std::chars_format::general entscheidet zwischen diesen Formen. std::chars_format::hex wählt die hexadezimale Schreibweise mit einem durch p gekennzeichneten Zweierpotenzexponenten und ohne 0x-Präfix.

Die Genauigkeit ist ein separates Argument von std::to_chars: Bei fixed und scientific gibt sie die Ziffern nach dem Dezimaltrennzeichen an, bei general die Genauigkeit der signifikanten Ziffern. Interpretiere sie nicht bei jedem Format als Anzahl der Nachkommastellen. Die Funktion fügt keinen abschließenden Nullterminator an; prüfe ec und verwende den Bereich bis ptr.

Bei der Eingabe mit std::from_chars erfordert scientific einen Exponenten, fixed lässt keinen zu, und das Standardformat general akzeptiert beide Formen. Das Format hex verarbeitet kein 0x-Präfix: Bei 0x123 kann es erfolgreich nur 0 einlesen und x123 übrig lassen. Wenn die gesamte Eingabe verarbeitet werden muss, prüfe sowohl ec als auch ptr == last.

Beispiele

#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';
    }
}

Ergebnis

12.500
1.250e+01
12.5

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen