std::getline

来自cppreference.com
< cpp‎ | string‎ | basic string

该页由英文版wiki使用Google Translate机器翻译而来。

该翻译可能存在错误或用词不当。鼠标停留在文本上可以看到原版本。你可以帮助我们修正错误或改进翻译。参见说明请点击这里.

点击这里参见该页的英文版本


 
C++
 
字符串库
null结尾的字符串
原文：
Null-terminated strings
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
字节的字符串
多字节字符串
宽字符串
类
原文：
Classes
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
basic_string
char_traits
 
std::basic_string
成员函数
原文：
Member functions
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
basic_string::basic_string
basic_string::operator=
basic_string::assign
basic_string::get_allocator
元素的访问
原文：
Element access
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
basic_string::at
basic_string::operator[]
basic_string::front（C++11）
basic_string::back（C++11）
basic_string::data
basic_string::c_str
迭代器
原文：
Iterators
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
basic_string::begin
basic_string::cbegin
（C++11）
basic_string::end
basic_string::cend
（C++11）
basic_string::rbegin
basic_string::crbegin
（C++11）
basic_string::rend
basic_string::crend
（C++11）
容量
原文：
Capacity
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
basic_string::empty
basic_string::size
basic_string::length
basic_string::max_size
basic_string::reserve
basic_string::capacity
basic_string::shrink_to_fit（C++11）
操作
原文：
Operations
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
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
搜索
原文：
Search
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
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
常量
原文：
Constants
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
basic_string::npos
非成员函数
原文：
Non-member functions
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
operator+
operator==
operator!=
operator<
operator>
operator<=
operator>=
swap(std::basic_string)
operator<<
operator>>
getline
stoi
stol
stoll		（C++11）
（C++11）
（C++11）
stoul
stoull		（C++11）
（C++11）
stof
stod
stold		（C++11）
（C++11）
（C++11）
to_string（C++11）
to_wstring（C++11）
Helper类
原文：
Helper classes
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
hash<std::string>
hash<std::wstring>
hash<std::u32string>
hash<std::u16string>		（C++11）
 
在头文件 <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:
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
1)
的行为就像UnformattedInputFunction，除了input.gcount()不会受到影响。在构造和检查岗哨对象的，执行以下操作：
原文：
Behaves as UnformattedInputFunction, except that input.gcount() is not affected. After constructing and checking the sentry object, performs the following:
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
1)
调用str.erase()
原文：
Calls str.erase()
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
2)
input并把它们添加到str的字符提取出来，直到发生以下情况之一中列出的顺序进行检查
原文：
Extracts characters from input and appends them to str until one of the following occurs (checked in the order listed)
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
a)
上input文件结束的条件，在这种情况下，getline套eofbit和回报.
原文：
end-of-file condition on input, in which case, getline sets eofbit and returns.
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
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.
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
c)
str.max_size()字符，在这种情况下，已经被存储getline集failbit并返回.
原文：
str.max_size() characters have been stored, in which case getline sets failbit and returns.
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
3)
如果没有字符提取任何理由（甚至没有被丢弃的分隔符），getline套failbit，并返回.
原文：
If no characters were extracted for whatever reason (not even the discarded delimiter), getline sets failbit and returns.
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
2)
同getline(input, str, input.widen(’\n’))，也就是默认的分隔符是底线字符.
原文：
Same as getline(input, str, input.widen(’\n’)), that is, the default delimiter is the endline character.
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

[编辑] 参数

input -
流中获取数据
原文：
the stream to get data from
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
str -
把数据转换成字符串
原文：
the string to put the data into
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
delim -
分隔符
原文：
the delimiter character
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

[编辑] 返回值

input

[编辑] 示例

下面的代码要求用户输入他们的名字，然后迎接他们用这个名字.
原文：
The following code asks the user for their name, then greets them using that name.
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

#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.";
}

Possible output: 

What is your name? John Q. Public
Hello John Q. Public, nice to meet you.
来自“http://zh.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/getline&oldid=38546”