std::quoted

< cpp‎ | io‎ | manip
 
C++
 
输入/输出库
 
输入/输出操纵符
浮点格式化
整数格式化
布尔格式化
域宽与填充控制
其他格式化
空白符处理
输出冲入
状态标志操纵
时间与金钱 I/O
(C++11)
(C++11)
(C++11)
(C++11)
带引号操纵符
quoted
(C++14)
 
定义于头文件 <iomanip>
template< class CharT >

/*unspecified*/ quoted(const CharT* s,

                       CharT delim=CharT('"'), CharT escape=CharT('\\'));
 (1) (C++14 起)
template< class CharT, class Traits, class Allocator >

/*unspecified*/ quoted(const std::basic_string<CharT, Traits, Allocator>& s,

                       CharT delim=CharT('"'), CharT escape=CharT('\\'));
 (2) (C++14 起)
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) (C++14 起)

允许插入或释出带引号字符串，例如在 CSV 或 XML 中找到者。

用于表达式 out << quoted(s, delim, escape) ，其中 out 为拥有等于 CharT 的 char_type 的输出流，对于重载 2-4 ，还拥有等于 Traits 的 traits_type 时，表现为有格式输出函数 (FormattedOutputFunction) ，它插入以如下方式构造的字符序列 seq 到 out ：

a) 首先，添加字符 delim 到序列
b) 然后添加每个来自 s 的字符，除非下个要输出的字符等于 delim 或等于 escape （以流的 traits_type::eq 确定），否则首先后附 escape 的额外副本
c) 最后，后附 delim 多一次到 seq

然后，若 seq.size() < out.width() ，则添加 out.width()-seq.size() 个填充字符 out.fill() 副本到序列的末尾（若 out.flags() 中设置了 ios_base::left ）或到序列的起始（所有其他情况下）。

最后，如同以调用 out.rdbuf()->sputn(seq, n) 输出来自每个结果序列的字符，其中 n=std::max(out.width(), seq.size()) ，并调用 out.width(0) 取消 std::setw 的效果，若存在。

4) 用于表达式 in >> quoted(s, delim, escape) 中，其中 in 是拥有等于 CharT 的 char_type 和等于 Traits 的 traits_type 输入流时，用 std::basic_istream::operator>> 按照下列规则从 in 释出字符：
a) 若首个释出的字符不等于 delim （以流的 traits_type::eq 确定），则简单地进行 in >> s 。
b) 否则（若首字符是分隔符）：
1) 关闭输入流上的 skipws 标志
2) 通过调用 s.clear() 清空目标字符串
3) 从 in 释出字符并后附字符到 s ，除了凡在释出 escape 字符时，忽略该字符并后附下个字符到 s 。 !in==true 时或找到未转义的 delim 字符时释出停止。
4) 舍弃最终（未转义）的 delim 字符。
5) 恢复输入流上的 skipws 标志为其原值。

参数

s - 要插入或释出的字符串
delim - 用作分隔符的字符，默认为 "
escape - 用作转义字符的字符，默认为 \

返回值

返回未指定类型对象，使得上述行为发生。

异常

若 operator>> 或 operator<< 抛出则抛出 std::ios_base::failure 。

示例

运行此代码
#include <iostream>
#include <iomanip>
#include <sstream>
 
int main()
{
    std::stringstream ss;
    std::string in = "String with spaces, and embedded \"quotes\" too";
    std::string out;
 
    auto show = [&](const auto& what) {
        &what == &in
            ?   std::cout << "read in     [" << in << "]\n"
                          << "stored as   [" << ss.str() << "]\n"
            :   std::cout << "written out [" << out << "]\n\n";
    };
 
    ss << std::quoted(in);
    show(in);
    ss >> std::quoted(out);
    show(out);
 
    ss.str(""); // clear the stream buffer
 
    in = "String with spaces, and embedded $quotes$ too";
    const char delim {'$'};
    const char escape {'%'};
 
    ss << std::quoted(in, delim, escape);
    show(in);
    ss >> std::quoted(out, delim, escape);
    show(out);
}

输出： 

read in     [String with spaces, and embedded "quotes" too]
stored as   ["String with spaces, and embedded \"quotes\" too"]
written out [String with spaces, and embedded "quotes" too]
 
read in     [String with spaces, and embedded $quotes$ too]
stored as   [$String with spaces, and embedded %$quotes%$ too$]
written out [String with spaces, and embedded $quotes$ too]

参阅