std::getline

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 );

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 );

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 );

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 );

getline 入力ストリームから文字を読み取り、文字列に格納します。

パラメータ

戻り値

input

注記

空白文字で区切られた入力（例： int n ; std:: cin >> n ; ）を読み込む場合、後続の空白文字（改行文字を含む）は入力ストリームに残されます。その後、行指向の入力に切り替えた場合、 getline で取得される最初の行はその空白文字だけになります。この動作が望ましくない場合、考えられる解決策には以下があります：

• 明示的な冗長な初期呼び出し getline 。
• 連続する空白文字の削除 std:: cin >> std:: ws による。
• 入力行の残存文字の無視 cin. ignore ( std:: numeric_limits < std:: streamsize > :: max ( ) , ' \n ' ) ; による。

例

#include <iostream>
#include <sstream>
#include <string>
int main()
{
    // ユーザーへの挨拶
    std::string name;
    std::cout << "What is your name? ";
    std::getline(std::cin, name);
    std::cout << "Hello " << name << ", nice to meet you.\n";
    // ファイルを行単位で読み取り
    std::istringstream input;
    input.str("1\n2\n3\n4\n5\n6\n7\n");
    int sum = 0;
    for (std::string line; std::getline(input, line);)
        sum += std::stoi(line);
    std::cout << "\nThe sum is " << sum << ".\n\n";
    // セパレータを使用して行の一部を読み取り
    std::istringstream input2;
    input2.str("a;b;c;d");
    for (std::string line; std::getline(input2, line, ';');)
        std::cout << line << '\n';
}

What is your name? John Q. Public
Hello John Q. Public, nice to meet you.
The sum is 28.
a
b
c
d

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目