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

CKTIS / C++

std::to_chars — zapis števila v znakovni medpomnilnik

std::to_chars zapiše besedilno predstavitev števila v medpomnilnik, ki ga zagotovi klicatelj. Rezultat vsebuje kazalec na konec in kodo napake; funkcija ne doda zaključnega '\0'.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

#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, deklariran v <charconv>, zapiše število v veljavno zapisljivo območje [first, last). Ne doda '\0' in ne sproži izjem. Dobljene podatke obravnavaj kot območje znakov, ne samodejno kot ničelno zaključeni niz.

Vrnjeni std::to_chars_result vsebuje std::to_chars_result::ptr tipa char* in std::to_chars_result::ec tipa std::errc. Če velja ec == std::errc{}, je pretvorba uspela: ptr kaže takoj za zadnjim zapisanim znakom, ptr - first pa določa dolžino. Če je medpomnilnik premajhen, velja ec == std::errc::value_too_large in ptr == last; vsebina območja ni določena. Tega medpomnilnika ne uporabi kot delni rezultat.

Pri celih številih je base privzeto 10 in mora biti v območju 2–36. Števke nad 9 se zapišejo kot a–z; negativne vrednosti dobijo -. Preobremenitev za bool je odstranjena. Preobremenitve za števila s plavajočo vejico neobvezno sprejmejo std::chars_format in natančnost; uporabljajo pravila oblikovanja področne nastavitve "C", ne glede na trenutne področne nastavitve.

Primer preveri ec, preden uporabi ptr, in ustvari std::string_view z izrecno določeno dolžino. Namenjen je prevajanju z -std=c++23; ne potrjuje izvajanja v produkcijskem okolju. Viri eel.is prikazujejo razvijajoči se delovni osnutek, zato lahko vsebujejo dodatke, ki so nastali po C++23.

Primeri

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

Rezultat

ff

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri