Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::from_chars: bezalokačný prevod zo znakov

std::from_chars analyzuje číslo v [first, last) a bez výnimiek vracia koniec a chybový kód.

Verzia: C++23

Syntax

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> analyzuje celé číslo z výslovne ohraničeného rozsahu znakov; iné preťaženie spracuje plávajúce čísla a std::chars_format. Vrátený std::from_chars_result obsahuje std::from_chars_result::ptr na prvý nezodpovedajúci znak a chybový kód std::from_chars_result::ec. Funkcia nealokuje, nezávisí od locale a nepotrebuje nulové ukončenie.

Príklad číta začiatok "2a rest" v základe 16. Nastaví value na 42, ptr nechá za dvoma znakmi a vráti prázdny std::errc, preto vypíše 42 2 1. Úvodné medzery sa nepreskakujú. Celočíselná forma neprijíma +, - iba pre signed cieľ a ani v základe 16 neuznáva prefix 0x.

Bez zhodného znaku platí ptr == first, errc::invalid_argument a value sa nezmení. Mimo rozsahu typu platí errc::result_out_of_range, hodnota opäť zostane, ale ptr označí koniec rozpoznanej sekvencie. Základ musí byť 2..36. Floating forma sleduje chars_format: exponent je povinný pre scientific, zakázaný pre fixed, bez prefixu 0x v hex režime.

Príklady

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

Výsledok

42 2 1

std::from_chars → 42 2 1

Zdroje