std::quoted

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(C++20)

语言支持库

概念库(C++20)

诊断库

内存管理库

元编程库(C++11)

通用工具库

容器库

迭代器库

范围库(C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库(C++17)

并发支持库(C++11)

执行控制库(C++26)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数(C++23)

C 风格 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

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

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步的输出

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_flushnoemit_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 > /* 未指明 */ quoted(const CharT* s,                     CharT delim = CharT('"'), CharT escape = CharT('\\'));	(1)	(C++14 起)
template<class CharT, class Traits, class Allocator > /* 未指明 */ quoted(conststd::basic_string<CharT, Traits, Allocator>& s,                     CharT delim = CharT('"'), CharT escape = CharT('\\'));	(2)	(C++14 起)
template<class CharT, class Traits> /* 未指明 */ quoted(std::basic_string_view<CharT, Traits> s,                     CharT delim = CharT('"'), CharT escape = CharT('\\'));	(3)	(C++17 起)
template<class CharT, class Traits, class Allocator > /* 未指明 */ quoted(std::basic_string<CharT, Traits, Allocator>& s,                     CharT delim=CharT('"'), CharT escape=CharT('\\'));	(4)	(C++14 起)

允许插入或提取带引号字符串，例如在 CSV 或 XML 中出现的那些。

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

a) 首先，向序列添加字符 delim。

b) 然后是 s 中的每个字符，但若下个要输出的字符等于 delim 或等于 escape（以流的 traits_type::eq 确定），则首先后附一个额外的 escape 副本。

c) 最后，再次向 seq 后附 delim。

然后，若 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 <iomanip>#include <iostream>#include <sstream>   void default_delimiter(){conststd::string in ="std::quoted() quotes this string and embedded \"quotes\" too";std::stringstream ss; ss << std::quoted(in);std::string out; ss >> std::quoted(out);   std::cout<<"默认分隔符的情形:\n""读取为 ["<< in <<"]\n""存储为 ["<< ss.str()<<"]\n""写出为 ["<< out <<"]\n\n";}   void custom_delimiter(){constchar delim{'$'};constchar escape{'%'};   conststd::string in ="std::quoted() quotes this string and embedded $quotes$ $too";std::stringstream ss; ss << std::quoted(in, delim, escape);std::string out; ss >> std::quoted(out, delim, escape);   std::cout<<"自定义分隔符的情形:\n""读取为 ["<< in <<"]\n""存储为 ["<< ss.str()<<"]\n""写出为 ["<< out <<"]\n\n";}   int main(){ default_delimiter(); custom_delimiter();}

输出：

默认分隔符的情形: 读取为 [std::quoted() quotes this string and embedded "quotes" too] 存储为 ["std::quoted() quotes this string and embedded \"quotes\" too"] 写出为 [std::quoted() quotes this string and embedded "quotes" too]   自定义分隔符的情形: 读取为 [std::quoted() quotes this string and embedded $quotes$ $too] 存储为 [$std::quoted() quotes this string and embedded %$quotes%$ %$too$] 写出为 [std::quoted() quotes this string and embedded $quotes$ $too]

参阅

format (C++20)

在新字符串中存储参数的格式化表示 (函数模板)