Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::from_chars: conversión sin asignación desde caracteres

std::from_chars analiza un número en [first, last) y devuelve el final y un código de error sin excepciones.

Versión: C++23

Sintaxis

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> analiza un entero en un rango de caracteres acotado explícitamente; otra sobrecarga trata coma flotante y std::chars_format. El std::from_chars_result devuelto contiene std::from_chars_result::ptr, que apunta al primer carácter no coincidente, y el código de error std::from_chars_result::ec. No asigna memoria, es independiente de locale y no necesita terminador nulo.

El ejemplo lee el inicio de "2a rest" en base 16. Pone value a 42, deja ptr tras dos caracteres y obtiene un std::errc vacío, por lo que imprime 42 2 1. No omite espacios iniciales. La forma entera no acepta +, solo acepta - para destino con signo y no reconoce 0x ni siquiera en base 16.

Si ningún carácter coincide, devuelve ptr == first y errc::invalid_argument, sin cambiar value. Fuera del rango del tipo devuelve errc::result_out_of_range y tampoco cambia value, aunque ptr marca el final reconocido. La base debe ser 2..36. El formato flotante sigue chars_format: exponente obligatorio en scientific, prohibido en fixed, y tampoco reconoce prefijo 0x en modo hex.

Ejemplos

#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';
}

Resultado

42 2 1

std::from_chars → 42 2 1

Fuentes