後述のパターンに対して文字シーケンス [first,last) を解析します。 1文字もパターンにマッチしない場合、またはマッチした文字を解析することによって取得した値が value の型で表現できない場合、 value は変更されず、そうでなければ、パターンにマッチした文字が value に格納される算術値のテキスト表現として解釈されます。

[編集] 引数

[編集] 戻り値

成功した場合は、 ptr がパターンにマッチしなかった最初の文字またはすべての文字がマッチしたのであれば last に等しい値を持ち、 ec が値初期化された、 from_chars_result 型の値を返します。

パターンにマッチしなかった場合は、 ptr が first と等しく、 ec が std::errc::invalid_argument と等しい、 from_chars_result 型の値を返します。 value は変更されません。

パターンはマッチしたけれども、解析した値が value の型で表現可能な範囲内でない場合は、 ec が std::errc::result_out_of_range と等しく、 ptr がパターンにマッチしなかった最初の文字を指す、 from_chars_result 型の値を返します。 value は変更されません。

[編集] 例外

(なし)

[編集] ノート

C++ および C のライブラリの他の解析関数と異なり、 std::from_chars はロケール非依存であり、確保を行わず、例外を投げません。 他のライブラリ (std::sscanf など) によって使用されるパースポリシーの小さなサブセットのみが提供されます。 これは、テキストベースのやりとり (JSON や XML) などの、一般的な高スループットの文脈において便利な、可能な最も高速な実装を可能とすることが意図されています。

to_chars によってフォーマットされたすべての浮動小数点値が std::from_chars で正確に復元できるという保証は、両方の関数が同じ処理系による場合にのみ提供されます。

後に数字が続かない符号から構成されるパターンは何にもマッチしないパターンとして扱われます。

[編集] 例

#include <iostream>
#include <charconv>
#include <array>
 
int main()
{
    std::array<char, 10> str{"42"};
    int result;
    if(auto [p, ec] = std::from_chars(str.data(), str.data()+str.size(), result);
       ec == std::errc())
        std::cout << result;
}

42

[編集] 欠陥報告

以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。

[編集] 関連項目