WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::to_chars — eine Zahl in einen Zeichenpuffer schreiben

std::to_chars schreibt die Textdarstellung einer Zahl in einen vom Aufrufer bereitgestellten Puffer. Das Ergebnis enthält einen Zeiger auf das Ende und einen Fehlercode; die Funktion hängt kein abschließendes '\0' an.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <charconv>
std::to_chars(first, last, value);
std::to_chars(first, last, integer_value, base);
std::to_chars(first, last, floating_value, fmt);
std::to_chars(first, last, floating_value, fmt, precision);

std::to_chars aus dem Header <charconv> schreibt eine Zahl in den gültigen, beschreibbaren Bereich [first, last). Die Funktion hängt kein '\0' an und löst keine Ausnahmen aus. Behandle die erzeugten Daten als Zeichenbereich und nicht automatisch als nullterminierte Zeichenkette.

Das zurückgegebene std::to_chars_result enthält std::to_chars_result::ptr vom Typ char* und std::to_chars_result::ec vom Typ std::errc. Wenn ec == std::errc{} gilt, war die Konvertierung erfolgreich: ptr zeigt direkt hinter das letzte geschriebene Zeichen, und ptr - first ergibt die Länge. Ist der Puffer zu klein, gilt ec == std::errc::value_too_large und ptr == last; der Inhalt des Bereichs ist dann nicht festgelegt. Verwende diesen Puffer nicht als Teilergebnis.

Für Ganzzahlen ist base standardmäßig 10 und muss zwischen 2 und 36 liegen. Ziffern über 9 werden als a–z geschrieben; negative Werte erhalten ein -. Die Überladung für bool ist gelöscht. Gleitkomma-Überladungen akzeptieren optional std::chars_format und eine Genauigkeit; sie verwenden unabhängig von den aktuellen Locale-Einstellungen die Formatierungsregeln des Locale "C".

Das Beispiel prüft ec, bevor es ptr verwendet, und erstellt ein std::string_view mit expliziter Länge. Es ist für die Kompilierung mit -std=c++23 vorgesehen und bestätigt nicht das Verhalten zur Laufzeit in einer Produktionsumgebung. Die eel.is-Quellen zeigen einen sich weiterentwickelnden Arbeitsentwurf und können daher Ergänzungen enthalten, die später als C++23 hinzugefügt wurden.

Beispiele

#include <charconv>
#include <cstddef>
#include <iostream>
#include <string_view>
#include <system_error>

int main() {
    char buffer[16];
    const std::to_chars_result result =
        std::to_chars(buffer, buffer + sizeof buffer, 255, 16);

    if (result.ec != std::errc{}) {
        std::cerr << "conversion failed\n";
        return 1;
    }

    const std::string_view text(
        buffer, static_cast<std::size_t>(result.ptr - buffer));
    std::cout << text << '\n';
}

Ergebnis

ff

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