to_chars_result.md

to_chars_result

• charconv[meta header]
• class[meta id-type]
• std[meta namespace]
• cpp17[meta cpp]

namespace std {
  struct to_chars_result {
    char* ptr;
    errc ec;
  };
}

概要

to_charsの戻り値となる変換の成否と追加情報を表現するクラス。

メンバ変数

名前	説明	対応バージョン
ptr	成功した場合、書き込まれた最後の文字の次の位置を指すポインタ。	C++17
ec	成功ならec == errc{}、失敗ならばerrc::value_too_largeを表すerrcの値。	C++17

メンバ関数

成否判定

名前	説明	対応バージョン
operator bool	変換に成功したかを判定する	C++26

比較演算子

名前	説明	対応バージョン
friend bool operator==(const to_chars_result&, const to_chars_result&) = default;	等値比較を行う	C++20
friend bool operator!=(const to_chars_result&, const to_chars_result&);	非等値比較を行う (==により使用可能)	C++20

詳細はto_charsの戻り値の項を参照のこと。

バージョン

言語

• C++17

処理系

• Clang: 7.0 [mark verified]
• GCC: 8.0 [mark verified]
• Visual C++: 2017 update 7 [mark verified]

関連項目

• to_chars

参照

• P0067R5: Elementary string conversions, revision 5
• P0682R1: Repairing elementary string conversions
• P1614R2 The Mothership has Landed
  • C++20での三方比較演算子の追加と、関連する演算子の自動導出