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
- C++ working draft — Input/output library [input.output]
- C++ working draft — Primitive numeric conversions [charconv]
- C++ working draft — Header <charconv> synopsis [charconv.syn]
- C++ working draft — Primitive numeric output conversion [charconv.to.chars]
- C++ working draft (HTML rendering on eel.is) — Primitive numeric output conversion [charconv.to.chars]