C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 输入/输出操纵符
- std::showpoint, std::noshowpoint
- std::setprecision
- std::fixed, std::scientific, std::hexfloat, std::defaultfloat
- std::setbase
- std::showbase, std::noshowbase
- std::quoted
- std::boolalpha, std::noboolalpha
- std::dec, std::hex, std::oct
- std::setfill
- std::setw
- std::left, std::right, std::internal
- std::showpos, std::noshowpos
- std::uppercase, std::nouppercase
- std::ws
- std::ends
- std::skipws, std::noskipws
- std::flush
- std::endl
- std::flush_emit
- std::unitbuf, std::nounitbuf
- std::emit_on_flush, std::no_emit_on_flush
- std::resetiosflags
- std::setiosflags
- std::get_money
- std::get_time
- std::put_money
- std::put_time
- C 风格文件输入/输出
- std::basic_streambuf
- std::basic_filebuf
- std::basic_stringbuf
- std::strstreambuf
- std::basic_syncbuf
- std::basic_ios
- std::basic_istream
- std::ios_base
- std::basic_osyncstream
- std::basic_ostream
- std::basic_iostream
- std::basic_ifstream
- std::basic_ofstream
- std::basic_fstream
- std::basic_istringstream
- std::basic_ostringstream
- std::basic_stringstream
- std::istrstream
- std::ostrstream
- std::strstream
- std::streamoff
- std::streamsize
- std::fpos
- std::iostream_category
- std::io_errc
- std::cin, std::wcin
- std::cout, std::wcout
- std::cerr, std::wcerr
- std::clog, std::wclog
- 注释
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
std::quoted
定义于头文件 <iomanip>
|
||
template< class CharT > /*unspecified*/ quoted(const CharT* s, |
(1) | (C++14 起) |
template< class CharT, class Traits, class Allocator > /*unspecified*/ quoted(const std::basic_string<CharT, Traits, Allocator>& s, |
(2) | (C++14 起) |
template< class CharT, class Traits> /*unspecified*/ quoted(std::basic_string_view<CharT, Traits> s, |
(3) | (C++17 起) |
template< class CharT, class Traits, class Allocator > /*unspecified*/ quoted(std::basic_string<CharT, Traits, Allocator>& s, |
(4) | (C++14 起) |
允许插入或释出带引号字符串,例如在 CSV 或 XML 中找到者。
用于表达式 out << quoted(s, delim, escape) ,其中 out
为拥有等于 CharT
的 char_type
的输出流,对于重载 2-4 ,还拥有等于 Traits
的 traits_type
时,表现为有格式输出函数 (FormattedOutputFunction) ,它插入以如下方式构造的字符序列 seq
到 out :
delim
到序列s
的字符,除非下个要输出的字符等于 delim
或等于 escape
(以流的 traits_type::eq
确定),否则首先后附 escape
的额外副本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 的效果,若存在。
in
是拥有等于 CharT
的 char_type
和等于 Traits
的 traits_type
输入流时,用 std::basic_istream::operator>> 按照下列规则从 in 释出字符:delim
(以流的 traits_type::eq
确定),则简单地进行 in >> s 。in
释出字符并后附字符到 s
,除了凡在释出 escape
字符时,忽略该字符并后附下个字符到 s
。 !in==true 时或找到未转义的 delim
字符时释出停止。delim
字符。参数
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; ss << std::quoted(in); std::cout << "read in [" << in << "]\n" << "stored as [" << ss.str() << "]\n"; ss >> std::quoted(out); std::cout << "written out [" << out << "]\n"; }
输出:
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]