basic_streambuf::sgetn

До _Count извлечение символов из входного буфера и их сохранение в безопасном буфере _Ptr.

Этот метод в принципе является небезопасным, так как он полагается на участнике, чтобы проверить, переданные значения верны.

streamsize sgetn(
   char_type *_Ptr,
   streamsize _Count
);

Параметры

• _Ptr
  Буфер, который должен содержать извлеченные символы.

• _Count
  Количество элементов, которые необходимо считать.

Возвращаемое значение

Количество прочитанных элементов.Дополнительные сведения см. в разделе streamsize.

Заметки

Функция-член возвращает xsgetn(_Ptr, _Count).

Пример

// basic_streambuf_sgetn.cpp
// compile with: /EHsc /W3
#include <iostream>
#include <fstream>

int main()
{
    using namespace std;

    ifstream myfile("basic_streambuf_sgetn.txt", ios::in);
    char a[10];

    // Extract 3 characters from myfile and store them in a.
    streamsize i = myfile.rdbuf()->sgetn(&a[0], 3);  // C4996
    a[i] = myfile.widen('\0');

    // Display the size and contents of the buffer passed to sgetn.
    cout << i << " " << a << endl;

    // Display the contents of the original input buffer.
    cout << myfile.rdbuf() << endl;
}

Вход: basic_streambuf_sgetn.txt

testing

Output

3 tes
ting

Требования

заголовок: <streambuf>

std пространство имен:

См. также

Ссылки

basic_streambuf Class

программирование iostream

соглашения iostreams