basic_streambuf::sgetn

Os extratos até caracteres de _Count do buffer de entrada e armazená-las em buffer fornecido _Ptr.

Este método é potencialmente perigosos, porque depende do chamador para verificar se os valores passados estão corretos.

streamsize sgetn(
   char_type *_Ptr,
   streamsize _Count
);

Parâmetros

• _Ptr
  o buffer para conter os caracteres extraídos.

• _Count
  O número de elementos à leitura.

Valor de retorno

O número de elementos.Consulte streamsize para maiores informações.

Comentários

a função de membro retorna xsgetn(_Ptr, _Count).

Exemplo

// 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;
}

Entrada: basic_streambuf_sgetn.txt

testing

Saída

3 tes
ting

Requisitos

Cabeçalho: <streambuf>

namespace: STD

Consulte também

Referência

basic_streambuf Class

iostream de programação

Convenções de iostreams