Standard Template Library Programmer's Guide

template<class charT, class traits, class Alloc> basic_string<charT, traits, Alloc> operator+(const basic_string<charT, traits, Alloc>& s1, const basic_string<charT, traits, Alloc>& s2) String concatenation. Equivalent to creating a temporary copy of s, appending s2, and then returning the temporary copy. template<class charT, class traits, class Alloc> basic_string<charT, traits, Alloc> operator+(const charT* s1, const basic_string<charT, traits, Alloc>& s2) String concatenation. Equivalent to creating a temporary basic_string object from s1, appending s2, and then returning the temporary object. template<class charT, class traits, class Alloc> basic_string<charT, traits, Alloc> operator+(const basic_string<charT, traits, Alloc>& s1, const charT* s2) String concatenation. Equivalent to creating a temporary copy of s, appending s2, and then returning the temporary copy. template<class charT, class traits, class Alloc> basic_string<charT, traits, Alloc> operator+(charT c, const basic_string<charT, traits, Alloc>& s2) String concatenation. Equivalent to creating a temporary object with the constructor basic_string(1, c), appending s2, and then returning the temporary object. template<class charT, class traits, class Alloc> basic_string<charT, traits, Alloc> operator+(const basic_string<charT, traits, Alloc>& s1, charT c) String concatenation. Equivalent to creating a temporary object, appending c with push_back, and then returning the temporary object. template<class charT, class traits, class Alloc> bool operator== (const charT* s1, const basic_string<charT, traits, Alloc>& s2) String equality. Equivalent to basic_string(s1).compare(s2) == 0. template<class charT, class traits, class Alloc> bool operator== (const basic_string<charT, traits, Alloc>& s1, const charT* s2) String equality. Equivalent to basic_string(s1).compare(s2) == 0. template<class charT, class traits, class Alloc> bool operator!= (const charT* s1, const basic_string<charT, traits, Alloc>& s2) String inequality. Equivalent to basic_string(s1).compare(s2) == 0. template<class charT, class traits, class Alloc> bool operator!= (const basic_string<charT, traits, Alloc>& s1, const charT* s2) String inequality. Equivalent to !(s1 == s2). template<class charT, class traits, class Alloc> bool operator< (const charT* s1, const basic_string<charT, traits, Alloc>& s2) String comparison. Equivalent to !(s1 == s2). template<class charT, class traits, class Alloc> bool operator< (const basic_string<charT, traits, Alloc>& s1, const charT* s2) String comparison. Equivalent to !(s1 == s2). template<class charT, class traits, class Alloc> basic_istream<charT, traits>& operator>>(basic_istream<charT, traits>& is, basic_string<charT, traits, Alloc>& s) Reads s from the input stream is. Specifically, it skips whitespace, and then replaces the contents of s with characters read from the input stream. It continues reading characters until it encounters a whitespace character (in which case that character is not extracted), or until end-of-file, or, if is.width() is nonzero, until it has read is.width() characters. This member function resets is.width() to zero. template<class charT, class traits, class Alloc> basic_ostream<charT, traits>& operator>>(basic_istream<charT, traits>& is, const basic_string<charT, traits, Alloc>& s) Writes s to the output stream is. It writes max(s.size(), is.width()) characters, padding as necessary. This member function resets is.width() to zero. template<class charT, class traits, class Alloc> basic_istream<charT, traits>& getline(basic_istream<charT, traits>& is, basic_string<charT, traits, Alloc>& s, charT delim) Replaces the contents of s with characters read from the input stream. It continues reading characters until it encounters the character delim (in which case that character is extracted but not stored in s ), or until end of file. Note that getline , unlike operator>>, does not skip whitespace. As the name suggests, it is most commonly used to read an entire line of text precisely as the line appears in an input file.