Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::from_chars: pretvorba iz znakov brez dodeljevanja

std::from_chars razčleni število v [first, last) ter brez izjem vrne konec in kodo napake.

Različica: C++23

Sintaksa

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) iz <charconv> razčleni celo število iz izrecno omejenega območja znakov; druga preobremenitev obravnava plavajoča števila in std::chars_format. Vrnjeni std::from_chars_result vsebuje std::from_chars_result::ptr do prvega neujemajočega znaka in kodo napake std::from_chars_result::ec. Ne dodeljuje, ni odvisen od locale in ne potrebuje ničelnega zaključka.

Primer bere začetek "2a rest" v osnovi 16. value nastavi na 42, ptr pusti za dvema znakoma in vrne prazen std::errc, zato izpiše 42 2 1. Začetnih presledkov ne preskoči. Cela oblika ne sprejme +, - le za signed cilj, in niti pri osnovi 16 ne prizna predpone 0x.

Brez ujemajočega znaka so rezultat ptr == first, errc::invalid_argument in nespremenjen value. Zunaj obsega tipa sledi errc::result_out_of_range, vrednost ostane, ptr pa označi konec prepoznanega zaporedja. Osnova mora biti 2..36. Plavajoča oblika sledi chars_format: eksponent zahtevan pri scientific, prepovedan pri fixed, brez 0x v hex načinu.

Primeri

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

Rezultat

42 2 1

std::from_chars → 42 2 1

Viri