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

CKTIS / C++

std::to_chars — zápis čísla do znakového buffera

std::to_chars zapisuje textovú reprezentáciu čísla do buffera poskytnutého volajúcim. Výsledok obsahuje ukazovateľ na koniec a chybový kód; funkcia nepridáva ukončovacie '\0'.

Verzia: C++23; repository compiler flag, production runtime not attested

Syntax

#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 deklarované v <charconv> zapisuje číslo do platného zapisovateľného rozsahu [first, last). Nepridáva '\0' a nevyhadzuje výnimky. S výslednými údajmi zaobchádzaj ako s rozsahom znakov, nie automaticky ako s reťazcom ukončeným nulou.

Vrátený std::to_chars_result obsahuje std::to_chars_result::ptr typu char* a std::to_chars_result::ec typu std::errc. Ak platí ec == std::errc{}, konverzia prebehla úspešne: ptr ukazuje hneď za posledný zapísaný znak a ptr - first udáva dĺžku. Ak je buffer príliš malý, platí ec == std::errc::value_too_large a ptr == last; obsah rozsahu nie je špecifikovaný. Nepoužívaj tento buffer ako čiastočný výsledok.

Pri celých číslach je base predvolene 10 a musí byť v rozsahu 2–36. Číslice nad 9 sa zapisujú ako a–z; záporné hodnoty dostanú -. Preťaženie pre bool je odstránené. Preťaženia pre čísla s pohyblivou desatinnou čiarkou voliteľne prijímajú std::chars_format a presnosť; používajú pravidlá formátovania locale "C" bez ohľadu na aktuálne nastavenia locale.

Príklad kontroluje ec pred použitím ptr a vytvára std::string_view s výslovne určenou dĺžkou. Je určený na kompiláciu s -std=c++23; nepotvrdzuje správanie za behu v produkčnom prostredí. Zdroje eel.is predstavujú vyvíjajúci sa pracovný návrh, a preto môžu obsahovať dodatky novšie než C++23.

Príklady

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

Výsledok

ff

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje