std:: to_chars

value を文字列に変換し、範囲 [ first , last ) を連続的に埋めていきます。ここで [ first , last ) は 有効な範囲 である必要があります。

パラメータ

戻り値

成功時は、型 std::to_chars_result の値を返し、 ec が値初期化された std::errc と等しく、 ptr が書き込まれた文字の終端次ポインタとなる。なお、文字列は NUL終端 されていないことに注意。

エラーの場合、 std::to_chars_result 型の値を返し、 std::errc::value_too_large を ec に保持し、値 last のコピーを ptr に格納し、範囲 [ first , last ) の内容を未規定の状態のままにする。

例外

例外を送出しません。

注記

C++およびCライブラリの他のフォーマット関数とは異なり、 std::to_chars はロケール非依存、メモリ確保なし、例外送出なしの特性を持ちます。他のライブラリ（例えば std::sprintf など）で使用されるフォーマットポリシーのごく一部のみが提供されています。これは、テキストベースの相互変換（ JSON や XML ）のような一般的な高スループット環境で有用な、可能な限り最速の実装を可能にすることを目的としています。

std::from_chars によってすべての浮動小数点値を正確に復元できるという保証は、両方の関数が同じ実装からのものである場合にのみ提供されます。

bool 値を "0" / "1" としてフォーマットするには、 std::to_chars を使用する際に値を他の整数型にキャストする必要があります。

例

#include <charconv>
#include <iomanip>
#include <iostream>
#include <string_view>
#include <system_error>
void show_to_chars(auto... format_args)
{
    const size_t buf_size = 10;
    char buf[buf_size]{};
    std::to_chars_result result = std::to_chars(buf, buf + buf_size, format_args...);
    if (result.ec != std::errc())
        std::cout << std::make_error_code(result.ec).message() << '\n';
    else
    {
        std::string_view str(buf, result.ptr - buf);
        std::cout << std::quoted(str) << '\n';
    }
}
int main()
{
    show_to_chars(42);
    show_to_chars(+3.14159F);
    show_to_chars(-3.14159, std::chars_format::fixed);
    show_to_chars(-3.14159, std::chars_format::scientific, 3);
    show_to_chars(3.1415926535, std::chars_format::fixed, 10);
}

"42"
"3.14159"
"-3.14159"
"-3.142e+00"
Value too large for defined data type

欠陥報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目