std::operator<<,>>
From cppreference.com
< cpp | string | basic string
| Defined in header <string>
|
||
| template <class CharT, class Traits, class Allocator> std::basic_ostream<CharT, Traits>& |
(1) | |
| template <class CharT, class Traits, class Allocator> std::basic_istream<CharT, Traits>& |
(2) | |
Inserts or extracts a string from a character stream.
1) Writes the string str to the stream os.
2) Clears str, then reads characters from is and stores them in str.
Characters are extracted and appended onto str until either:
- N characters are read, where N is is.width() if is.width() > 0, otherwise N is str.max_size(),
- an EOF marker is read from is, or
- isspace(c,is.getloc()) is true for the next character in is.
If no characters are extracted then std::ios::failbit is set on is, which may throw std::ios_base::failure.
Contents |
[edit] Exceptions
1) (none)
2) may throw std::ios_base::failure if no characters are extracted from is
[edit] Parameters
| os | - | a character output stream |
| is | - | a character input stream |
| str | - | the string to be inserted or extracted |
[edit] Return value
1) os
2) is
[edit] Example
#include <iostream> #include <string> int main() { std::string greeting = "Hello, whirled!" std::cout << greeting << '\n'; }
Output:
Hello, whirled!
