Compartilhar via


basic_filebuf::overflow

Chamado quando um novo caractere é inserido em um buffer cheio.

virtual int_type overflow( 
   int_type _Meta = traits_type::eof 
);

Parâmetros

  • _Meta
    O caractere a ser inserido no buffer ou em traits_type::eof.

Valor de retorno

Se a função não pode ser bem-sucedida, retornará traits_type::eof. Caso contrário, retorna traits_type::not_eof(_Meta).

Comentários

Se _Meta != traits_type::eof, a função de membro virtual protegida se esforça inserir o elemento ch = traits_type::to_char_type(_Meta) no buffer de saída. Pode fazer isso em muitas maneiras:

  • Se uma posição de gravação estiver disponível, pode armazenar o elemento na posição de gravação e incrementar o próximo ponteiro para o buffer de saída.

  • Pode fazer uma posição de gravação disponível atribuindo o novo ou armazenamento adicional para o buffer de saída.

  • É possível converter todas as saídas pendentes no buffer de saída, seguido por ch, usando a facetafac de conversão de arquivo para chamar quando necessário fac.out . Cada elemento chde caracteres do tipo assim gerado é gravado no fluxo associado designado pelo ponteiro de arquivo fp como se por chamadas sucessivas do formulário fputc(ch, fp). Se qualquer conversão ou gravação falhar, a função não terá êxito.

Requisitos

fstream <deCabeçalho: >

Namespace: std

Consulte também

Referência

Classe basic_filebuf

Programação iostream

Convenções iostreams