CKTIS / C++
std::from_chars : conversion sans allocation depuis des caractères
std::from_chars analyse un nombre dans [first, last) et renvoie fin et code d’erreur sans exception.
Version : C++23
Syntaxe
struct std::from_chars_result {
const char* ptr;
std::errc ec;
};
constexpr std::from_chars_result std::from_chars(
const char* first, const char* last, /* integer type */& value, int base = 10);
std::from_chars_result std::from_chars(
const char* first, const char* last, /* floating type */& value,
std::chars_format fmt = std::chars_format::general);std::from_chars(first, last, value, base) de <charconv> analyse un entier dans une plage explicitement bornée ; une autre surcharge traite les flottants et std::chars_format. Le std::from_chars_result renvoyé contient std::from_chars_result::ptr, qui désigne le premier caractère non apparié, et le code d’erreur std::from_chars_result::ec. Il n’alloue rien, ne dépend pas de la locale et ne demande aucun zéro terminal.
L’exemple lit le début de "2a rest" en base 16. Il fixe value à 42, place ptr après deux caractères et laisse std::errc vide, donc affiche 42 2 1. Aucun espace initial n’est sauté. Pour un entier, + initial est refusé, - n’est permis que pour une destination signée et 0x n’est pas un préfixe, même en base 16.
Sans caractère apparié, on obtient ptr == first, errc::invalid_argument et value inchangé. Hors plage du type, errc::result_out_of_range laisse aussi value inchangé, tandis que ptr marque la fin reconnue. La base entière doit être 2..36. Le flottant suit chars_format : exposant requis pour scientific, interdit pour fixed, et aucun préfixe 0x en mode hex.
Exemples
#include <charconv>
#include <iostream>
#include <string_view>
#include <system_error>
int main() {
const std::string_view text = "2a rest";
int value = -1;
const auto result = std::from_chars(text.data(), text.data() + text.size(), value, 16);
std::cout << value << ' ' << (result.ptr - text.data()) << ' '
<< (result.ec == std::errc{}) << '\n';
}
Résultat
42 2 1
std::from_chars → 42 2 1