CKTIS / C++
std::from_chars: bezalokační převod ze znaků
std::from_chars analyzuje číslo v [first, last) a bez výjimek vrací konec a chybový kód.
Verze: C++23
Syntaxe
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ýslovně ohraničeného rozsahu znaků; jiné přetížení zpracuje plovoucí čísla a std::chars_format. Vrácený std::from_chars_result obsahuje std::from_chars_result::ptr na první neodpovídající znak a chybový kód std::from_chars_result::ec. Funkce nealokuje, nezávisí na locale a nepotřebuje nulové ukončení.
Příklad čte začátek "2a rest" v základu 16. Nastaví value na 42, ptr nechá za dvěma znaky a vrátí prázdný std::errc, proto vypíše 42 2 1. Úvodní mezery se nepřeskakují. Celočíselná forma nepřijímá +, - jen pro signed cíl a ani v základu 16 neuznává prefix 0x.
Bez shodného znaku platí ptr == first, errc::invalid_argument a value se nezmění. Mimo rozsah typu platí errc::result_out_of_range, hodnota opět zůstane, ale ptr označí konec rozpoznané sekvence. Základ musí být 2..36. Floating forma sleduje chars_format: exponent je povinný pro scientific, zakázaný pro fixed, bez prefixu 0x v hex režimu.
Pří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ýsledek
42 2 1
std::from_chars → 42 2 1