namespace std {
template <class CharT>
unspecified quoted(const CharT* s,
CharT delim=CharT('"'),
CharT escape=CharT('\\')); // (1)
template <class CharT, class Traits, class Allocator>
unspecified quoted(const std::basic_string<CharT, Traits, Allocator>& s,
CharT delim=CharT('"'),
CharT escape=CharT('\\')); // (2)
template <class CharT, class Traits>
unspecified quoted(std::basic_string_view<CharT, Traits> s,
CharT delim = CharT('"'),
CharT escape = CharT('\\')); // (3) C++17
template <class CharT, class Traits, class Allocator>
unspecified quoted(std::basic_string<CharT, Traits, Allocator>& s,
CharT delim=CharT('"'),
CharT escape=CharT('\\')); // (4)
}
概要
囲み文字指定で入出力する。
このマニピュレータを使用してcout << quoted("hello");
とすると、「"hello"
」のように、引用符で囲まれた文字列が出力される。逆に、引用符で囲まれた文字列をcin >> quoted(s);
のように入力すると、引用符が外された文字列を取得できる。
このような囲み文字を指定しての入出力は、たとえばXMLの属性や、CSVのフィールドで使用する。
- (1) : 出力用のオーバーロード。文字配列を、囲み文字で修飾する。
- (2) : 出力用のオーバーロード。
std::basic_string
型の文字列を、囲み文字で修飾する。 - (3) : 出力用のオーバーロード。
std::basic_string_view
型の文字列を、囲み文字で修飾する。 - (4) : 入力用のオーバーロード。囲み文字で修飾された入力から、囲まれている文字列を抽出する。
効果
- (1), (2), (3) : この関数で返された結果を出力ストリームに渡すと、以下のシーケンスが出力される。出力ストリームは、そのシーケンスに対して書式を適用する。
delim
を出力する。s
の各要素を出力する。それら要素がdelim
もしくはescape
と等しい場合、要素の前にescape
を出力する。- 文字の等値比較には、
std::char_traits<CharT>::eq()
を使用する。
- 文字の等値比較には、
delim
を出力する。
- (4) : この関数で返された結果を入力ストリームに渡すと、以下のように入力される。
- 開始の文字が、
std::char_traits<CharT>::eq()
関数で比較してdelim
と等価である場合、skipws
フラグをオフにする。s.clear()
を呼び出す。- エスケープされない
delim
が読み込まれるか、ストリームが終端に達するまで、s
に1文字ずつ読み込まれ追加される(escape
文字以外)。 - 最後の
delim
が破棄される。 skipws
フラグを、元の値に戻す。
- そうでない場合、
istream >> s
で読み込みが行われる。 - この関数で返された結果を出力ストリームに渡した場合は、(2)の動作となる。
- 開始の文字が、
例
#include <iostream>
#include <sstream>
#include <string_view>
#include <iomanip>
int main()
{
// (1) : ダブルクォーテーションで文字列を囲んで出力する
{
std::stringstream ss;
ss << std::quoted("hello");
std::cout << "(1) : " << ss.str() << std::endl;
}
// (2) : std::basic_string文字列をシングルクォーテーションで囲んで出力する
{
std::string s = "hello";
std::stringstream ss;
ss << std::quoted(s, '\'');
std::cout << "(2) : " << ss.str() << std::endl;
}
// (3) : std::basic_string_view文字列を、ダブルクォーテーションで囲んで出力する
{
std::string_view sv = "hello";
std::stringstream ss;
ss << std::quoted(sv);
std::cout << "(3) : " << ss.str() << std::endl;
}
// (4) : ダブルクォーテーションで囲まれた文字列を抽出する
{
std::stringstream ss;
ss << "\"hello\"";
std::string input;
ss >> std::quoted(input);
std::cout << "(4) : " << input << std::endl;
}
// (4) : ダブルクォーテーションで囲まれていない文字列も読み込める
{
std::stringstream ss;
ss << "hello";
std::string input;
ss >> std::quoted(input);
std::cout << "(4)-2 : " << input << std::endl;
}
}
出力
(1) : "hello"
(2) : 'hello'
(3) : "hello"
(4) : hello
(4)-2 : hello
バージョン
言語
- C++14
処理系
- Clang: 3.4 ✅
- GCC: 4.9 ✅
- ICC: ??
- Visual C++: ??