std::getline

 

C++

语言

标准库头文件

概念

实用工具库

字符串库

容器库

算法库

迭代器库

数值计算库

输入/输出库

本地化库

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

文件系统库 (C++17)

技术规范

 

字符串库

空终止字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

成员函数 basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator 元素访问 basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str basic_string::operator basic_string_view (C++17) 迭代器 basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) 容量 basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

操作 basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap 查找 basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of 常量 basic_string::npos

非成员函数 operator+ operator==operator!=operator<operator>operator<=operator>= swap(std::basic_string) operator<<operator>> getline stoistolstoll (C++11) (C++11) (C++11) stoulstoull (C++11) (C++11) stofstodstold (C++11) (C++11) (C++11) to_string (C++11) to_wstring (C++11) operator""s (C++14) 帮助类 hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string> (C++11) (C++11) (C++11) (C++11) 推导指引(C++17)

 

定义于头文件 <string>
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT,Traits>& getline( std::basic_istream<CharT,Traits>& input,                                            std::basic_string<CharT,Traits,Allocator>& str,                                            CharT delim );	(1)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT,Traits>& getline( std::basic_istream<CharT,Traits>&& input,                                            std::basic_string<CharT,Traits,Allocator>& str,                                            CharT delim );	(1)	(C++11 起)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT,Traits>& getline( std::basic_istream<CharT,Traits>& input,                                            std::basic_string<CharT,Traits,Allocator>& str );	(2)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT,Traits>& getline( std::basic_istream<CharT,Traits>&& input,                                            std::basic_string<CharT,Traits,Allocator>& str );	(2)	(C++11 起)

getline从输入流中读取字符，并把它们转换成字符串

原文：

getline reads characters from an input stream and places them into a string:

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

1)

的行为就像UnformattedInputFunction，除了input.gcount()不会受到影响。在构造和检查岗哨对象的，执行以下操作：

原文：

Behaves as UnformattedInputFunction, except that input.gcount() is not affected. After constructing and checking the sentry object, performs the following:

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

1)

调用str.erase()

原文：

Calls str.erase()

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

2)

input并把它们添加到str的字符提取出来，直到发生以下情况之一中列出的顺序进行检查

原文：

Extracts characters from input and appends them to str until one of the following occurs (checked in the order listed)

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

a)

上input文件结束的条件，在这种情况下，getline套eofbit和回报.

原文：

end-of-file condition on input, in which case, getline sets eofbit and returns.

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

b)

下一个可用的输入字符delim，Traits::eq(c, delim)，在这种情况下，分隔符是从input提取进行了测试，但不会追加到str.

原文：

the next available input character is delim, as tested by Traits::eq(c, delim), in which case the delimiter character is extracted from input, but is not appended to str.

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

c)

str.max_size()字符，在这种情况下，已经被存储getline集failbit并返回.

原文：

str.max_size() characters have been stored, in which case getline sets failbit and returns.

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

3)

如果没有字符提取任何理由（甚至没有被丢弃的分隔符），getline套failbit，并返回.

原文：

If no characters were extracted for whatever reason (not even the discarded delimiter), getline sets failbit and returns.

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

2)

同getline(input, str, input.widen(’\n’))，也就是默认的分隔符是底线字符.

原文：

Same as getline(input, str, input.widen(’\n’)), that is, the default delimiter is the endline character.

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

参数

input	-	流中获取数据 原文： the stream to get data from 文本通过谷歌翻译机器翻译。 你可以帮忙校正和验证翻译。点击此处查看指示。
str	-	把数据转换成字符串 原文： the string to put the data into 文本通过谷歌翻译机器翻译。 你可以帮忙校正和验证翻译。点击此处查看指示。
delim	-	分隔符 原文： the delimiter character 文本通过谷歌翻译机器翻译。 你可以帮忙校正和验证翻译。点击此处查看指示。

返回值

input

示例

下面的代码要求用户输入他们的名字，然后迎接他们用这个名字.

原文：

The following code asks the user for their name, then greets them using that name.

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

运行此代码

#include <string>
#include <iostream>
 
int main()
{
    std::string name;
    std::cout << "What is your name? ";
    std::getline(std::cin, name);
    std::cout << "Hello " << name << ", nice to meet you.";
}

可能的输出：

What is your name? John Q. Public
Hello John Q. Public, nice to meet you.