getline.md

getline

• string[meta header]
• std[meta namespace]
• function template[meta id-type]

namespace std {
  template <class CharT, class Traits, class Allocator>
  std::basic_istream<CharT, Traits>&
    getline(std::basic_istream<CharT, Traits>& is,
            basic_string<CharT, Traits, Allocator>& str);              // (1)

  template <class CharT, class Traits, class Allocator>
  std::basic_istream<CharT, Traits>&
    getline(std::basic_istream<CharT, Traits>&& is,
            basic_string<CharT, Traits, Allocator>& str);              // (2) C++11から

  template <class CharT, class Traits, class Allocator>
  std::basic_istream<CharT, Traits>&
    getline(std::basic_istream<CharT, Traits>& is,
            basic_string<CharT, Traits, Allocator>& str, CharT delim); // (3)

  template <class CharT, class Traits, class Allocator>
  std::basic_istream<CharT, Traits>&
    getline(std::basic_istream<CharT, Traits>&& is,
            basic_string<CharT, Traits, Allocator>& str, CharT delim); // (4) C++11から
}

概要

ストリームから改行文字が現れるまで（1行すべて）あるいは仮引数delimで指定された文字までの文字列を入力する。

この関数は、非書式化入力関数（basic_istreamを参照）として作用する。

効果

仮引数delimがないオーバーロードでは、std::getline(is, str, is.widen('\n'))を呼び出す。

仮引数delimを持つものは以下の通り。

1. basic_istream<>::sentryオブジェクトを構築する。sentryオブジェクトが失敗を示した場合、何もしない。
2. str.erase()を呼び出す。
3. 以下のいずれかを満たすまで、文字を入力してstr.append(1, c)と等価な方法で文字列に追加する。なお、cは入力した文字を表す。以下の条件判断はこの順で行う。
   1. EOFに達した。この場合、is.setstate(ios_base::eofbit)を呼び出す。
   2. Traits::eq(c, delim)が真となった。
   3. 読み取った文字数がstr.max_size()になるまで書き込んだ。この場合、is.setstate(ios_base::failbit)を呼び出す。
4. （sentryオブジェクトを破棄したのち）1文字も入力がなされなかったら、is.setstate(ios_base::failbit)を呼び出す。
   • 空行の場合はこれに該当しないことに注意。なぜなら、改行文字1文字を入力しているためである。

この関数はbasic_istream<>::gcountには影響を及ぼさない。

戻り値

• 仮引数is。

例

#include <iostream>
#include <string>

int main() {
  std::string s;
  if (std::getline(std::cin, s)) {
    std::cout << s << std::endl;
  }
}

• std::getline[color ff0000]
• std::cin[link /reference/iostream/cin.md]

入力

Haru wa akebono.

出力

Haru wa akebono.

関連項目

名前	説明
std::basic_istream<>::getline	文字の配列へ入力を行うもの