База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::from_chars: преобразуване от знаци без алокация

std::from_chars анализира число в [first, last) и без изключения връща край и код за грешка.

Версия: C++23

Синтаксис

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) от <charconv> анализира цяло число от явно ограничен диапазон знаци; друго претоварване обработва плаващи числа и std::chars_format. Върнатият std::from_chars_result съдържа std::from_chars_result::ptr към първия несъвпадащ знак и кода за грешка std::from_chars_result::ec. Няма алокация, зависимост от locale или нужда от нулев край.

Примерът чете началото на "2a rest" в основа 16. Задава value на 42, оставя ptr след два знака и връща празен std::errc, затова извежда 42 2 1. Начални интервали не се пропускат. Целият вариант не приема +, приема - само за signed цел и не разпознава 0x дори при основа 16.

Без съвпадащ знак резултатът е ptr == first, errc::invalid_argument и непроменено value. Извън диапазона на типа се връща errc::result_out_of_range, пак без промяна, а ptr сочи края на разпознатата последователност. Основата трябва да е 2..36. Floating вариантът следва chars_format: експонента е задължителна при scientific, забранена при fixed, без 0x в hex режим.

Примери

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

Резултат

42 2 1

std::from_chars → 42 2 1

Източници