Partilhar via


basic_streambuf::underflow

Função protegida, virtual para extrair o elemento atual do fluxo de entrada.

virtual int_type underflow( );

Valor de retorno

O elemento atual.

Comentários

A função de membro virtual protegida se esforça extrair o elemento atual ch do fluxo de entrada, sem em seguida a posição atual do fluxo, e retorna a **traits_type::**comoto_int_type(ch). Pode fazer isso em muitas maneiras:

  • Se uma posição de leitura estiver disponível, ch o elemento é armazenado na posição de leitura. Para obter mais informações a respeito, consulte a seção comentários de Classe basic_streambuf.

  • Pode fazer uma posição de leitura disponível atribuindo o novo ou armazenamento adicional para o buffer de entrada, ler em, em qualquer fonte externa, um ou mais elementos. Para obter mais informações a respeito, consulte a seção comentários de Classe basic_streambuf.

Se a função não pode ser bem-sucedida, retornará traits_type::EOF() ou lance uma exceção. Caso contrário, retorna o elemento atual no fluxo de entrada, convertidos conforme descrito anteriormente. O comportamento padrão é retornar traits_type::eof().

A função virtual de underflow , com as funções de sincronização e de estouro , define as características de streambuf- classe derivada. Cada classe derivada pode implementar underflow diferente, mas a interface com a classe de fluxo de chamada é a mesma.

A função de underflow com mais frequência será chamada por funções públicas de streambuf como sgetc e sgetn quando a área obter estiver vazia, mas outras classes, incluindo as classes de fluxo, podem chamar underflow a qualquer momento.

A função de underflow fornece a área obter com caracteres da fonte de entrada. Se a área obter contém caracteres, underflow retorna o primeiro caractere. Se a área obter estiver vazia, preenche a área obter e retorna o próximo caractere (que permite que na área obter). Se não houver mais caractere disponível, então underflow retorna EOF e sai da área obter vazia.

A classe de strstreambuf , underflow ajusta o ponteiro de egptr do armazenamento de acesso que foi atribuído dinamicamente por uma chamada a overflow.

Requisitos

streambuf <deCabeçalho: >

Namespace: std

Consulte também

Referência

Classe basic_streambuf

Programação iostream

Convenções iostreams