CKTIS / C++
std::to_chars — écrire un nombre dans un tampon de caractères
std::to_chars écrit la représentation textuelle d’un nombre dans un tampon fourni par l’appelant. Le résultat contient un pointeur de fin et un code d’erreur ; la fonction n’ajoute pas de '\0' final.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#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, déclaré dans <charconv>, écrit un nombre dans l’intervalle valide et modifiable [first, last). La fonction n’ajoute pas de '\0' et ne lance aucune exception. Traitez les données obtenues comme un intervalle de caractères, et non automatiquement comme une chaîne terminée par un caractère nul.
Le std::to_chars_result renvoyé contient std::to_chars_result::ptr de type char* et std::to_chars_result::ec de type std::errc. Si ec == std::errc{}, la conversion a réussi : ptr pointe juste après le dernier caractère écrit, et ptr - first donne la longueur. Si le tampon est trop petit, ec == std::errc::value_too_large et ptr == last ; le contenu de l’intervalle n’est alors pas spécifié. N’utilisez pas ce tampon comme résultat partiel.
Pour les entiers, base vaut 10 par défaut et doit être compris entre 2 et 36. Les chiffres supérieurs à 9 sont écrits sous la forme a–z ; les valeurs négatives reçoivent -. La surcharge pour bool est supprimée. Les surcharges à virgule flottante acceptent éventuellement std::chars_format et une précision ; elles appliquent les règles de formatage de la locale "C", quelles que soient les paramètres régionaux actuels.
L’exemple vérifie ec avant d’utiliser ptr et construit un std::string_view de longueur explicite. Il est destiné à être compilé avec -std=c++23 ; il ne confirme pas le comportement en exécution dans un environnement de production. Les sources eel.is présentent un projet de norme en évolution et peuvent donc contenir des ajouts postérieurs à C++23.
Exemples
#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';
}
Résultat
ff
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
- 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]