Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::from_chars: conversão sem alocação a partir de caracteres

std::from_chars analisa um número em [first, last) e devolve o fim e código de erro sem exceções.

Versão: C++23

Sintaxe

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> analisa um inteiro num intervalo de caracteres limitado; outra sobrecarga trata ponto flutuante e std::chars_format. O std::from_chars_result devolvido contém std::from_chars_result::ptr, que aponta para o primeiro carácter não correspondente, e o código de erro std::from_chars_result::ec. Não aloca, é independente de locale e não precisa de terminador nulo.

O exemplo lê o início de "2a rest" em base 16. Define value como 42, deixa ptr após dois caracteres e produz std::errc vazio, imprimindo 42 2 1. Não ignora espaço inicial. A forma inteira não aceita +, só aceita - para destino com sinal e não reconhece 0x mesmo em base 16.

Sem qualquer carácter correspondente, devolve ptr == first e errc::invalid_argument, sem alterar value. Fora do intervalo do tipo devolve errc::result_out_of_range, também sem alterar value, enquanto ptr marca o fim reconhecido. A base deve ser 2..36. O floating segue chars_format: expoente obrigatório em scientific, proibido em fixed, e também sem prefixo 0x no modo hex.

Exemplos

#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

Fontes