std::getline

 

C++

言語

ヘッダ

コンセプト

言語サポートライブラリ

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

アルゴリズムライブラリ

イテレータライブラリ

数値演算ライブラリ

入出力ライブラリ

ローカライゼーションライブラリ

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

ファイルシステムライブラリ (C++17)

技術仕様書

 

文字列ライブラリ

NULL終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

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::starts_with (C++20) basic_string::ends_with (C++20) 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) hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string> (C++20)(C++20)(C++20)(C++20) 推定ガイド(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 は入力ストリームから文字を読み込み、それを文字列に格納します。

1) UnformattedInputFunction と同様に動作しますが、 input.gcount() は影響されません。 sentry オブジェクトの構築および確認の後、以下のことを行います。

1) str.erase() を呼びます。

2) 以下のいずれかが発生するまで (上から順に確認されます)、 input から文字を抽出し、それを str に追加します。

a) input の end-of-file 状態。 この場合、 getline は eofbit を設定します。

b) 次の利用可能な文字が delim である。 判定は Traits::eq(c, delim) によって行われます。 この場合、区切り文字は input から抽出されますが、 str には追加されません。

c) str.max_size() 個の文字が格納された。 この場合、 getline は failbit を設定してリターンします。

3) いかなる理由においても、1文字も (破棄される区切り文字さえも) 抽出されなかった場合、 getline は failbit を設定してリターンします。

2) getline(input, str, input.widen('\n')) と同じです。 つまり、デフォルトの区切り文字は改行です。

引数

input	-	データを取得するストリーム
str	-	データを格納する文字列
delim	-	区切り文字

戻り値

input。

ノート

ホワイトスペースを区切り文字とする入力の直後、例えば int n; std::cin >> n; の後に使用した場合、 operator>> によって入力ストリームに残された改行文字を getline が消費し、ただちに戻ります。 一般的な解決方法は、行指向の入力に切り替える前に、 cin.ignore(std::numeric_limits<std::streamsize>::max(), '\n'); を使用して、入力行に残されたすべての文字を無視することです。

例

以下の例はユーザの入力を読み込むために getline 関数を使う方法およびファイルを行単位で処理する方法をデモンストレーションします。

Run this code

#include <string>
#include <iostream>
#include <sstream>
 
int main()
{
    // greet the user
    std::string name;
    std::cout << "What is your name? ";
    std::getline(std::cin, name);
    std::cout << "Hello " << name << ", nice to meet you.\n";
 
    // read file line by line
    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";
}

出力例:

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

関連項目

getline

指定された文字が発見されるまで文字を抽出します Original: extracts characters until the given character is found The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (std::basic_istreamのパブリックメンバ関数)