std::quoted

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Input/output library

I/O manipulators

C-style I/O

Buffers

basic_streambuf

basic_filebuf

basic_stringbuf

strstreambuf (deprecated)

Streams

Abstractions

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

File I/O

basic_ifstream

basic_ofstream

basic_fstream

String I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array I/O

istrstream (deprecated)

ostrstream (deprecated)

strstream (deprecated)

Types

streamoff

streamsize

fpos

Error category interface

iostream_category (C++11)

io_errc (C++11)

 

Input/output manipulators

Floating-point formatting
showpointnoshowpoint setprecision	fixedscientifichexfloatdefaultfloat (C++11)(C++11)
Integer formatting
setbase showbasenoshowbase	dechexoct
Boolean formatting
boolalphanoboolalpha
Field width and fill control
setfill setw	internalleftright
Other formatting
showposnoshowpos	uppercasenouppercase
Whitespace processing
ws ends	skipwsnoskipws
Output flushing
flush endl	unitbufnounitbuf
Status flags manipulation
resetiosflags	setiosflags
Time and money I/O
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (C++11)

 

Defined in header <iomanip>
template< class CharT > /*unspecified*/ quoted(const CharT* s,                        CharT delim=CharT(’"’), CharT escape=CharT(’\\’));	(1)	(since 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)	(since C++14)
template< class CharT, class Traits, class Allocator > /*unspecified*/ quoted(std::basic_string<CharT, Traits, Allocator>& s,                        CharT delim=CharT(’"’), CharT escape=CharT(’\\’));	(3)	(since C++14)

Allows insertion and extraction of quoted strings, such as the ones found in CSV or XML.

1,2) When used in an expression out << quoted(s, delim, escape), inserts into the output stream out the following characters (using appropriate operator<< overloads):

a) The character delim

b) Every character from s, except if the next character to output equals delim or equals escape (as determined by operator==), then first outputs an extra copy of escape

c) In the end, outputs delim once more

3) When used in an expression in >> quoted(s, delim, escape), extracts characters from the input stream in, using std::basic_istream::operator>>, according to the following rules:

a) If the first character extracted does not equal delim (as determined by operator==), then simply performs in >> s.

b) Otherwise (if the first character is the delimiter):

1) Turns off the skipws flag on the input stream

2) Empties the destination string by calling s.clear()

3) Extracts characters from in and appends them to s, except that whenever an escape character is extracted, it is ignored and the next character is appended to s. Extraction stops when !in==true or when an unescaped delim character is found.

4) Discards the final (unescaped) delim character.

5) Restores the skipws flag on the input stream to its original value.

Parameters

s	-	the string to insert or extract
delim	-	the character to use as the delimiter, defaults to "
escape	-	the character to use as the escape character, defaults to \

Return value

Returns an object of unspecified type such that the described behavior takes place.

Exceptions

Throws std::ios_base::failure if operator>> or operator<< throws.

Example

Run this code

#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 << "in:  '" << in << "'\n"
              << "stored as '" << ss.str() << "'\n";
 
    ss >> std::quoted(out);
    std::cout << "out: '" << out << "'\n";
}

Output:

in:  'String with spaces, and embedded "quotes" too'
stored as '"String with spaces, and embedded \"quotes\" too"'
out:  'String with spaces, and embedded "quotes" too'