std::quoted

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

输入/输出库

I/O 操纵符

C 风格 I/O

缓冲

basic_streambuf

basic_filebuf

basic_stringbuf

strstreambuf (C++98 中弃用)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

istrstream (C++98 中弃用)

ostrstream (C++98 中弃用)

strstream (C++98 中弃用)

同步的输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

输入/输出操纵符

浮点格式化
showpointnoshowpoint setprecision	fixedscientifichexfloatdefaultfloat (C++11)(C++11)
整数格式化
setbase showbasenoshowbase	dechexoct
布尔格式化
boolalphanoboolalpha
域宽与填充控制
setfill setw	internalleftright
其他格式化
showposnoshowpos	uppercasenouppercase
空白符处理
ws ends	skipwsnoskipws
输出冲入
flush endl flush_emit (C++20)	unitbufnounitbuf emit_on_flushno_emit_on_flush (C++20)(C++20)
状态标志操纵
resetiosflags	setiosflags
时间与金钱 I/O
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (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]