<string> 函数
getline
stod
stof
stoi
stol
stold
stoll
stoul
stoull
swap
to_string
to_wstring
getline
将字符串从输入流中一行一行地提取出来。
// (1) delimiter as parameter
template <class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
basic_istream<CharType, Traits>& in_stream,
basic_string<CharType, Traits, Allocator>& str,
CharType delimiter);
template <class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
basic_istream<CharType, Traits>&& in_stream,
basic_string<CharType, Traits, Allocator>& str,
const CharType delimiter);
// (2) default delimiter used
template <class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
basic_istream<CharType, Traits>& in_stream,
basic_string<CharType, Traits, Allocator>& str);
template <class Allocator, class Traits, class Allocator>
basic_istream<Allocator, Traits>& getline(
basic_istream<Allocator, Traits>&& in_stream,
basic_string<Allocator, Traits, Allocator>& str);
参数
in_stream
要从其中提取字符串的输入流。
str
从输入流读取的字符将放入的字符串。
delimiter
行分隔符。
返回值
输入流 in_stream。
备注
标记为 (1) 的一对函数签名从 in_stream 中提取字符，直到找到 delimiter，同时将它们存储在 str 中。
这对标记为 (2) 的函数签名使用换行符作为默认行分隔符，并且像 getline(in_stream, str, in_stream. widen('\n')) 那样执行。
每对函数中的第二个函数是第一个的模拟，它的作用是支持 rvalue 引用。
发生下列情况之一时，提取将停止：
在文件末尾的情况下，
in_stream的内部状态标志被设置为ios_base::eofbit。函数提取经比较与
delimiter相等的元素后。 元素不会被放回或追加到受控序列。函数提取
str.max_size个元素后。in_stream的内部状态标志设置为ios_base::failbit。除之前列出的错误之外的其他一些错误；
in_stream的内部状态标志设置为ios_base::badbit。
有关内部状态标志的信息，请参阅 ios_base::iostate。
如果函数没有提取任何元素，则 in_stream 的内部状态标志被设置为 ios_base::failbit。 在任何情况下，getline 返回 in_stream。
如果引发了异常，in_stream 和 str 将处于异常状态。
示例
以下代码演示两种模式下的 getline()：第一种使用默认分隔符（换行），第二种使用空格作为分隔符。 文件尾字符（键盘上的 CTRL-Z）用于控制 while 循环的终止。 此值会将 cin 的内部状态标志设置为 eofbit，后者必须使用 basic_ios::clear() 进行消除，这样第二个 while 循环才能正确运行。
// compile with: /EHsc /W4
#include <string>
#include <iostream>
#include <vector>
using namespace std;
int main()
{
string str;
vector<string> v1;
cout << "Enter a sentence, press ENTER between sentences. (Ctrl-Z to stop): " << endl;
// Loop until end-of-file (Ctrl-Z) is input, store each sentence in a vector.
// Default delimiter is the newline character.
while (getline(cin, str)) {
v1.push_back(str);
}
cout << "The following input was stored with newline delimiter:" << endl;
for (const auto& p : v1) {
cout << p << endl;
}
cin.clear();
vector<string> v2;
// Now try it with a whitespace delimiter
while (getline(cin, str, ' ')) {
v2.push_back(str);
}
cout << "The following input was stored with whitespace as delimiter:" << endl;
for (const auto& p : v2) {
cout << p << endl;
}
}
stod
将字符序列转换为 double。
double stod(
const string& str,
size_t* idx = 0);
double stod(
const wstring& str,
size_t* idx = 0
;
参数
str
要转换的字符序列。
idx
首个未转换字符的索引值。
返回值
double 值。
注解
该函数将 str 中元素的序列转换为类型 double 的值，就像通过调用 strtod( str.c_str(), _Eptr) 实现一样，其中，_Eptr 是该函数的内部对象。 如果 str.c_str() == *_Eptr，则将引发 invalid_argument 类型的对象。 如果此类调用将设置 errno，它将引发 out_of_range 类型的对象。 否则，如果 idx 不是 null 指针，则该函数会将 *_Eptr - str.c_str() 存储在 *idx 中并返回值。
stof
将字符序列转换为浮动的。
float stof(
const string& str,
size_t* idx = 0);
float stof(
const wstring& str,
size_t* idx = 0);
参数
str
要转换的字符序列。
idx
首个未转换字符的索引值。
返回值
float 值。
注解
该函数将 str 中元素的序列转换为类型 float 的值，就像通过调用 strtof( str.c_str(), _Eptr) 实现一样，其中，_Eptr 是该函数的内部对象。 如果 str.c_str() == *_Eptr，则将引发 invalid_argument 类型的对象。 如果此类调用将设置 errno，它将引发 out_of_range 类型的对象。 否则，如果 idx 不是 null 指针，则该函数会将 *_Eptr - str.c_str() 存储在 *idx 中并返回值。
stoi
将字符序列转换为整数。
int stoi(
const string& str,
size_t* idx = 0,
int base = 10);
int stoi(
const wstring& str,
size_t* idx = 0,
int base = 10);
返回值
整数值。
参数
str
要转换的字符序列。
idx
首个未转换字符的索引值。
base
要使用的号码基。
注解
函数 stoi 将 str 中的字符序列转换为 int 类型的值并返回该值。 例如，在传递字符序列“10”时，stoi 返回的值为整数 10.
当以 stoi 方式调用时，strtol 的行为方式与针对单字节字符的 strtol( str.c_str(), _Eptr, idx) 函数相似，其中，_Eptr 是函数的内部对象；而当以类似的方式调用 wcstol 时，其行为与针对宽字符的 wcstol(Str.c_str(), _Eptr, idx) 相似。 有关详细信息，请参阅 strtol、wcstol、_strtol_l、_wcstol_l。
如果 str.c_str() == *_Eptr、stoi 引发 invalid_argument 类型的对象。 如果此类调用将设置 errno，或者如果返回值无法表示为 int 类型的对象，则它将引发 out_of_range 类型的对象。 否则，如果 idx 不是 null 指针，则该函数会将 *_Eptr - str.c_str() 存储在 *idx 中。
stol
将字符序列转换为 long。
long stol(
const string& str,
size_t* idx = 0,
int base = 10);
long stol(
const wstring& str,
size_t* idx = 0,
int base = 10);
参数
str
要转换的字符序列。
idx
首个未转换字符的索引值。
base
要使用的号码基。
返回值
长整数的值。
注解
该函数将 str 中元素的序列转换为类型 long 的值，就像通过调用 strtol( str.c_str(), _Eptr, idx) 实现一样，其中，_Eptr 是该函数的内部对象。 如果 str.c_str() == *_Eptr，则将引发 invalid_argument 类型的对象。 如果此类调用将设置 errno，它将引发 out_of_range 类型的对象。 否则，如果 idx 不是 null 指针，则该函数会将 *_Eptr - str.c_str() 存储在 *idx 中并返回值。
stold
将字符序列转换为 long double。
double stold(
const string& str,
size_t* idx = 0);
double stold(
const wstring& str,
size_t* idx = 0);
参数
str
要转换的字符序列。
idx
首个未转换字符的索引值。
返回值
long double 值。
注解
该函数将 str 中元素的序列转换为类型 long double 的值，就像通过调用 strtold( str.c_str(), _Eptr) 实现一样，其中，_Eptr 是该函数的内部对象。 如果 str.c_str() == *_Eptr，则将引发 invalid_argument 类型的对象。 如果此类调用将设置 errno，它将引发 out_of_range 类型的对象。 否则，如果 idx 不是 null 指针，则该函数会将 *_Eptr - str.c_str() 存储在 *idx 中并返回值。
stoll
将字符序列转换为 long long。
long long stoll(
const string& str,
size_t* idx = 0,
int base = 10);
long long stoll(
const wstring& str,
size_t* idx = 0,
int base = 10);
参数
str
要转换的字符序列。
idx
首个未转换字符的索引值。
base
要使用的号码基。
返回值
long long 值。
注解
该函数将 str 中元素的序列转换为类型 long long 的值，就像通过调用 strtoll( str.c_str(), _Eptr, idx) 实现一样，其中，_Eptr 是该函数的内部对象。 如果 str.c_str() == *_Eptr，则将引发 invalid_argument 类型的对象。 如果此类调用将设置 errno，它将引发 out_of_range 类型的对象。 否则，如果 idx 不是 null 指针，则该函数会将 *_Eptr - str.c_str() 存储在 *idx 中并返回值。
stoul
将字符序列转换为无符号长整数。
unsigned long stoul(
const string& str,
size_t* idx = 0,
int base = 10);
unsigned long stoul(
const wstring& str,
size_t* idx = 0,
int base = 10);
参数
str
要转换的字符序列。
idx
首个未转换字符的索引值。
base
要使用的号码基。
返回值
无符号长整数的值。
备注
该函数将 str 中元素的序列转换为类型 unsigned long 的值，就像通过调用 strtoul( str.c_str(), _Eptr, idx) 实现一样，其中，_Eptr 是该函数的内部对象。 如果 str.c_str() == *_Eptr，则将引发 invalid_argument 类型的对象。 如果此类调用将设置 errno，它将引发 out_of_range 类型的对象。 否则，如果 idx 不是 null 指针，则该函数会将 *_Eptr - str.c_str() 存储在 *idx 中并返回值。
stoull
将字符序列转换为 unsigned long long。
unsigned long long stoull(
const string& str,
size_t* idx = 0,
int base = 10);
unsigned long long stoull(
const wstring& str,
size_t* idx = 0,
int base = 10);
参数
str
要转换的字符序列。
idx
首个未转换字符的索引值。
base
要使用的号码基。
返回值
unsigned long long 值。
注解
该函数将 str 中元素的序列转换为类型 unsigned long long 的值，就像通过调用 strtoull( str.c_str(), _Eptr, idx) 实现一样，其中，_Eptr 是该函数的内部对象。 如果 str.c_str() == *_Eptr，则将引发 invalid_argument 类型的对象。 如果此类调用将设置 errno，它将引发 out_of_range 类型的对象。 否则，如果 idx 不是 null 指针，则该函数会将 *_Eptr - str.c_str() 存储在 *idx 中并返回值。
swap
交换两个字符串的字符数组。
template <class Traits, class Allocator>
void swap(basic_string<CharType, Traits, Allocator>& left, basic_string<CharType, Traits, Allocator>& right);
参数
left
一个字符串，其元素将与另一个字符串的元素交换。
right
要与第一个字符串交换元素的另一个字符串。
备注
模板函数为字符串执行专用成员函数 left.swap(right)，此函数可保证恒定的复杂性。
示例
// string_swap.cpp
// compile with: /EHsc
#include <string>
#include <iostream>
int main( )
{
using namespace std;
// Declaring an object of type basic_string<char>
string s1 ( "Tweedledee" );
string s2 ( "Tweedledum" );
cout << "Before swapping string s1 and s2:" << endl;
cout << "The basic_string s1 = " << s1 << "." << endl;
cout << "The basic_string s2 = " << s2 << "." << endl;
swap ( s1 , s2 );
cout << "\nAfter swapping string s1 and s2:" << endl;
cout << "The basic_string s1 = " << s1 << "." << endl;
cout << "The basic_string s2 = " << s2 << "." << endl;
}
Before swapping string s1 and s2:
The basic_string s1 = Tweedledee.
The basic_string s2 = Tweedledum.
After swapping string s1 and s2:
The basic_string s1 = Tweedledum.
The basic_string s2 = Tweedledee.
to_string
将一个值转换为 string。
string to_string(int value);
string to_string(unsigned int value);
string to_string(long value);
string to_string(unsigned long value);
string to_string(long long value);
string to_string(unsigned long long value);
string to_string(float value);
string to_string(double value);
string to_string(long double value);
参数
value
要转换的值。
返回值
表示该值的 string。
备注
此函数可将 value 转换为存储在函数内部数组对象 Buf 中的元素序列，就像调用 sprintf(Buf, Fmt, value) 一样，其中 Fmt 是
"%d"（如果value的类型为int）"%u"（如果value的类型为unsigned int）"%ld"（如果value的类型为long）"%lu"（如果value的类型为unsigned long）"%lld"（如果value的类型为long long）"%llu"（如果value的类型为unsigned long long）"%f"（如果value的类型为float或double）"%Lf"（如果value的类型为long double）
该函数返回 string(Buf)。
to_wstring
将一个值转换为宽字符串。
wstring to_wstring(int value);
wstring to_wstring(unsigned int value);
wstring to_wstring(long value);
wstring to_wstring(unsigned long value);
wstring to_wstring(long long value);
wstring to_wstring(unsigned long long value);
wstring to_wstring(float value);
wstring to_wstring(double value);
wstring to_wstring(long double value);
参数
value
要转换的值。
返回值
表示该值的宽字符串。
注解
此函数可将 value 转换为存储在函数内部数组对象 Buf 中的元素序列，就像调用 swprintf(Buf, Len, Fmt, value) 一样，其中 Fmt 是
L"%d"（如果value的类型为int）L"%u"（如果value的类型为unsigned int）L"%ld"（如果value的类型为long）L"%lu"（如果value的类型为unsigned long）L"%lld"（如果value的类型为long long）L"%llu"（如果value的类型为unsigned long long）L"%f"（如果value的类型为float或double）L"%Lf"（如果value的类型为long double）
该函数返回 wstring(Buf)。