Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources