30 Input/output library [input.output]

Effects: Никто. Эта функция-член не ведет себя как неформатированная функция ввода (как описано выше).

Returns: Число символов, извлеченных последней неформатированной входной функцией-членом, вызванной для объекта.

Effects: Ведет себя как неформатированная функция ввода (как описано выше). После создания сторожевого объекта извлекает персонажаc, если он доступен. В противном случае вызовы функции setstate(failbit), которая может throw ios_­base​::​failure ([iostate.flags]),

Returns: c если доступно, в противном случае traits​::​eof().

Effects: Ведет себя как неформатированная функция ввода (как описано выше). После создания сторожевого объекта извлекает персонажа, если он доступен, и назначает егоc.311 В противном случае вызывается функция setstate(failbit) (которая может throw ios_­base​::​failure ([iostate.flags])).

Returns: *this.

Effects: Ведет себя как неформатированная функция ввода (как описано выше). После создания сторожевого объекта извлекает символы и сохраняет их в последовательных местах массива, первый элемент которого обозначен знаком s.312 Символы извлекаются и сохраняются до тех пор, пока не произойдет одно из следующих событий:

• (8.1)

  n меньше единицы илиn - 1 символы сохраняются;

• (8.2)

  конец файла происходит во входной последовательности (в этом случае функция вызывает setstate(eofbit));

• (8.3)

  traits​::​eq(c, delim) для следующего доступного входного символаc (в этом случаеc не извлекается).

Если функция не хранит символы, она вызывает setstate(failbit) (что может вызвать throw ios_­base​::​​failure ([iostate.flags])). В любом случае, еслиn он больше нуля, он сохраняет нулевой символ в следующем последовательном месте массива.

Returns: *this.

Effects: Звонки get(s, n, widen('\n')).

Returns: Значение, возвращаемое вызовом.

Effects: Ведет себя как неформатированная функция ввода (как описано выше). После создания сторожевого объекта извлекает символы и вставляет их в выходную последовательность, управляемую sb. Символы извлекаются и вставляются до тех пор, пока не произойдет одно из следующих событий:

• (13.1)

  конец файла встречается во входной последовательности;

• (13.2)

  вставка в выходную последовательность не выполняется (в этом случае вставляемый символ не извлекается);

• (13.3)

  traits​::​eq(c, delim) для следующего доступного входного символаc (в этом случаеc не извлекается);

• (13.4)

  возникает исключение (в этом случае исключение перехватывается, но не генерируется повторно).

Если функция не вставляет символы, она вызывает setstate(failbit), что может вызвать throw ios_­base​::​​failure ([iostate.flags]).

Returns: *this.

Effects: Звонки get(sb, widen('\n')).

Returns: Значение, возвращаемое вызовом.

Effects: Ведет себя как неформатированная функция ввода (как описано выше). После создания сторожевого объекта извлекает символы и сохраняет их в последовательных местах массива, первый элемент которого обозначен знаком s.313 Символы извлекаются и сохраняются до тех пор, пока не произойдет одно из следующих событий:

1. 1.конец файла происходит во входной последовательности (в этом случае функция вызывает setstate(eofbit));

2. 2.traits​::​eq(c, delim) для следующего доступного входного символаc (в этом случае входной символ извлекается, но не сохраняется);314

3. 3.n меньше единицы илиn - 1 символы сохраняются (в этом случае функция вызывает setstate(​failbit)).

Эти условия проверяются в указанном порядке.315

Если функция не извлекает символы, она вызывает setstate(failbit) (что может вызвать throw ios_­base​::​​failure ([iostate.flags])).316

В любом случае, еслиn он больше нуля, он затем сохраняет нулевой символ (использование charT()) в следующем последовательном месте массива.

Returns: *this.

[ Example:

#include <iostream>

int main() {
  using namespace std;
  const int line_buffer_size = 100;

  char buffer[line_buffer_size];
  int line_number = 0;
  while (cin.getline(buffer, line_buffer_size, '\n') || cin.gcount()) {
    int count = cin.gcount();
    if (cin.eof())
      cout << "Partial final line";   // cin.fail() is false
    else if (cin.fail()) {
      cout << "Partial long line";
      cin.clear(cin.rdstate() & ~ios_base::failbit);
    } else {
      count--;                        // Don't include newline in count
      cout << "Line " << ++line_number;
    }
    cout << " (" << count << " chars): " << buffer << endl;
  }
}

 — end example ]

Returns: getline(s, n, widen('\n'))

Effects: Ведет себя как неформатированная функция ввода (как описано выше). После создания объекта-часового извлекает персонажей и отбрасывает их. Символы извлекаются до тех пор, пока не произойдет одно из следующих событий:

• (25.1)

  n != numeric_­limits<streamsize>​::​max() и n персонажи были извлечены до сих пор

• (25.2)

  конец файла происходит во входной последовательности (в этом случае вызывается функция setstate(eofbit), которая может throw ios_­base​::​failure ([iostate.flags]));

• (25.3)

  traits​::​eq_­int_­type(traits​::​to_­int_­type(c), delim) для следующего доступного входного символаc (в этом случаеc извлекается).

Remarks: Последнее условие никогда не произойдет, если traits​::​eq_­int_­type(delim, traits​::​eof()).

Returns: *this.

Effects: Ведет себя как неформатированная функция ввода (как описано выше). После создания сторожевого объекта считывает, но не извлекает текущий входной символ.

Returns: traits​::​eof() если good() есть false. В противном случае возвращается rdbuf()->sgetc().

Effects: Ведет себя как неформатированная функция ввода (как описано выше). После создания сторожевого объекта, если !good() вызовы, setstate(failbit) которые могут вызвать исключение, и возврат. В противном случае извлекает символы и сохраняет их в последовательных местах массива, первый элемент которого обозначен знаком s.317 Символы извлекаются и сохраняются до тех пор, пока не произойдет одно из следующих событий:

• (30.1)

  n символы сохраняются;

• (30.2)

  конец файла происходит во входной последовательности (в этом случае вызывается функция setstate(failbit | eofbit), которая может throw ios_­base​::​failure ([iostate.flags])).

Returns: *this.

Effects: Ведет себя как неформатированная функция ввода (как описано выше). После создания сторожевого объекта, если !good() вызовы, setstate(failbit) которые могут вызвать исключение, и возврат. В противном случае извлекает символы и сохраняет их в последовательных местах массива, первый элемент которого обозначен знаком s. Если rdbuf()->in_­avail() == -1, вызывает setstate(eofbit) (который может throw ios_­base​::​failure ([iostate.flags])) и не извлекает символы;

• (32.1)

  Если rdbuf()->in_­avail() == 0, не извлекает символы

• (32.2)

  Если rdbuf()->in_­avail() > 0, извлекает min(rdbuf()->in_­avail(), n)).

Returns: Количество извлеченных символов.

Effects: Ведет себя как неформатированная функция ввода (как описано выше), за исключением того, что функция сначала очищаетсяeofbit. После создания сторожевого объекта, если !good() вызовы, setstate(failbit) которые могут вызвать исключение, и возврат. Если rdbuf() не равно нулю, вызывает rdbuf->sputbackc(). Если rdbuf() имеет значение null, или если sputbackc() возвращается traits​::​eof(), вызывает setstate(badbit) (который может throw ios_­base​::​failure ([iostate.flags])). [  Note: Эта функция не извлекает символы, поэтому при следующем вызове возвращается значение gcount() 0. ] — end note 

Returns: *this.

Effects: Ведет себя как неформатированная функция ввода (как описано выше), за исключением того, что функция сначала очищаетсяeofbit. После создания сторожевого объекта, если !good() вызовы, setstate(failbit) которые могут вызвать исключение, и возврат. Если rdbuf() не равно нулю, вызывает rdbuf()->sungetc(). Если rdbuf() имеет значение null, или если sungetc() возвращается traits​::​eof(), вызывает setstate(badbit) (который может throw ios_­base​::​failure ([iostate.flags])). [  Note: Эта функция не извлекает символы, поэтому при следующем вызове возвращается значение gcount() 0. ] — end note 

Returns: *this.

Effects: Ведет себя как неформатированная функция ввода (как описано выше), за исключением того, что она не подсчитывает количество извлеченных символов и не влияет на значение, возвращаемое последующими вызовами gcount(). После создания сторожевого объекта rdbuf() возвращается пустой указатель-1. В противном случае вызывает rdbuf()->pubsync() и, если эта функция возвращает-1 вызовы setstate(badbit) (которые могут вызывать throw ios_­base​::​failure ([iostate.flags]), и возвращает -1. В противном случае возвращает ноль.

Effects: Ведет себя как неформатированная функция ввода (как описано выше), за исключением того, что она не подсчитывает количество извлеченных символов и не влияет на значение, возвращаемое последующими вызовами gcount().

Returns: После создания сторожевого объекта, если fail() != false, возвращается, pos_­type(-1) чтобы указать на сбой. В противном случае возвращается rdbuf()->pubseekoff(0, cur, in).

Effects: Ведет себя как неформатированная функция ввода (как описано выше), за исключением того, что функция сначала очищаетeofbit, она не подсчитывает количество извлеченных символов и не влияет на значение, возвращаемое последующими вызовами gcount(). После создания сторожевого объекта if fail() != trueвыполняется rdbuf()->pubseekpos(pos, ios_­base​::​in). В случае неудачи вызовы функции setstate(failbit) (которые могут выкинуть ios_­base​::​failure).

Returns: *this.

Effects: Ведет себя как неформатированная функция ввода (как описано выше), за исключением того, что функция сначала очищаетeofbit, не подсчитывает количество извлеченных символов и не влияет на значение, возвращаемое последующими вызовамиgcount(). После создания сторожевого объекта if fail() != trueвыполняется rdbuf()->pubseekoff(off, dir, ios_­base​::​in). В случае неудачи вызовы функцииsetstate(​failbit) (которые могут выкинуть ios_­base​::​failure).

Returns: *this.