<string>

Defines the container template class basic_string and various supporting templates.

For more information about basic_string, see basic_string Class

#include <string>

Remarks

The C++ language and the Standard C++ Library support two types of strings:

• Null-terminated character arrays often referred to as C strings.

• Template class objects, of type basic_string, that handle all char-like template arguments.

Typedefs

string	A type that describes a specialization of the template class basic_string with elements of type char as a string.
wstring	A type that describes a specialization of the template class basic_string with elements of type wchar_t as a wstring.
u16string	A type that describes a specialization of the template class basic_string based on elements of type char16_t.
u32string	A type that describes a specialization of the template class basic_string based on elements of type char32_t.

Operators

operator+	Concatenates two string objects.
operator!=	Tests if the string object on the left side of the operator is not equal to the string object on the right side.
operator==	Tests if the string object on the left side of the operator is equal to the string object on the right side.
operator<	Tests if the string object on the left side of the operator is less than to the string object on the right side.
operator<=	Tests if the string object on the left side of the operator is less than or equal to the string object on the right side.
operator<<	A template function that inserts a string into the output stream.
operator>	Tests if the string object on the left side of the operator is greater than to the string object on the right side.
operator>=	Tests if the string object on the left side of the operator is greater than or equal to the string object on the right side.
operator>>	A template function that extracts a string from the input stream.

Specialized Template Functions

swap	Exchanges the arrays of characters of two strings.
stod	Converts a character sequence to a double.
stof	Converts a character sequence to a float.
stoi	Converts a character sequence to an integer.
stold	Converts a character sequence to a long double.
stoll	Converts a character sequence to a long long.
stoul	Converts a character sequence to an unsigned long.
stoull	Converts a character sequence to an unsigned long long.
to_string	Converts a value to a string.
to_wstring	Converts a value to a wide string.

Functions

getline Template Function

Extract strings from the input stream line by line.

Classes

basic_string Class	A template class that describes objects that can store a sequence of arbitrary character-like objects.
char_traits Struct	A template class that describes attributes associated with a character of type CharType

Specializations

char_traits<char> Struct	A struct that is a specialization of the template struct char_traits<CharType> to an element of type char.
char_traits<wchar_t> Struct	A struct that is a specialization of the template struct char_traits<CharType> to an element of type wchar_t.
char_traits<char16_t> Struct	A struct that is a specialization of the template struct char_traits<CharType> to an element of type char16_t.
char_traits<char32_t> Struct	A struct that is a specialization of the template struct char_traits<CharType> to an element of type char32_t.

Requirements

• Header: <string>

• Namespace: std

See Also

Reference

Thread Safety in the C++ Standard Library

Other Resources

C++ Standard Library Header Files