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

CKTIS / C++

std::to_chars — записване на число в символен буфер

std::to_chars записва текстовото представяне на число в буфер, предоставен от извикващия. Резултатът съдържа указател към края и код за грешка; функцията не добавя завършващ '\0'.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#include <charconv>
std::to_chars(first, last, value);
std::to_chars(first, last, integer_value, base);
std::to_chars(first, last, floating_value, fmt);
std::to_chars(first, last, floating_value, fmt, precision);

std::to_chars, декларирана в <charconv>, записва число във валидния, записваем диапазон [first, last). Не добавя '\0' и не хвърля изключения. Третирайте получените данни като диапазон от символи, а не автоматично като низ, завършващ с нулев символ.

Върнатият std::to_chars_result съдържа std::to_chars_result::ptr от тип char* и std::to_chars_result::ec от тип std::errc. Когато ec == std::errc{}, преобразуването е успешно: ptr сочи непосредствено след последния записан символ, а ptr - first дава дължината. Ако буферът е твърде малък, ec == std::errc::value_too_large и ptr == last; съдържанието на диапазона не е специфицирано. Не използвайте този буфер като частичен резултат.

За целите числа base по подразбиране е 10 и трябва да е в диапазона 2–36. Цифрите над 9 се записват като a–z; отрицателните стойности получават -. Претоварването за bool е премахнато. Претоварванията за числа с плаваща запетая приемат по избор std::chars_format и точност; използват правилата за форматиране на локал "C", независимо от текущите настройки за локал.

Примерът проверява ec, преди да използва ptr, и създава std::string_view с изрично зададена дължина. Предназначен е за компилиране с -std=c++23; не удостоверява поведението при изпълнение в производствена среда. Източниците eel.is представят развиващ се работен проект, затова може да съдържат допълнения, появили се след C++23.

Примери

#include <charconv>
#include <cstddef>
#include <iostream>
#include <string_view>
#include <system_error>

int main() {
    char buffer[16];
    const std::to_chars_result result =
        std::to_chars(buffer, buffer + sizeof buffer, 255, 16);

    if (result.ec != std::errc{}) {
        std::cerr << "conversion failed\n";
        return 1;
    }

    const std::string_view text(
        buffer, static_cast<std::size_t>(result.ptr - buffer));
    std::cout << text << '\n';
}

Резултат

ff

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници