Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::from_chars: bezalokacyjna konwersja z zakresu znaków

std::from_chars analizuje liczbę w [first, last), zwracając koniec dopasowania i kod błędu bez wyjątków.

Wersja: C++23

Składnia

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) z <charconv> analizuje liczbę całkowitą w jawnie ograniczonym zakresie znaków; osobny overload obsługuje liczby zmiennoprzecinkowe i std::chars_format. Zwracany std::from_chars_result zawiera std::from_chars_result::ptr, wskazujący pierwszy niedopasowany znak, oraz std::from_chars_result::ec z kodem błędu. Funkcja nie alokuje, nie zależy od locale i nie wymaga zakończenia zerem.

Przykład czyta początek "2a rest" w bazie 16. Ustawia value na 42, zatrzymuje ptr po dwóch znakach i pozostawia pusty std::errc, dlatego drukuje 42 2 1. Parser nie pomija początkowych białych znaków. Dla liczb całkowitych nie przyjmuje +, a - tylko dla typu ze znakiem; nawet przy bazie 16 prefiks 0x nie należy do wzorca.

Brak choć jednego dopasowanego znaku daje ptr == first, errc::invalid_argument i nie zmienia value. Wynik poza zakresem typu daje errc::result_out_of_range, również bez zmiany value, lecz ptr nadal wskazuje koniec rozpoznanej sekwencji. Baza całkowita musi należeć do 2..36. Wariant float ma reguły zależne od chars_format (np. wymagany wykładnik dla scientific, zakazany dla fixed) i także nie rozpoznaje prefiksu 0x w trybie hex.

Przykłady

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

Wynik

42 2 1

std::from_chars → 42 2 1

Źródła