Partilhar via


basic_filebuf::seekoff

Tentar modificar os cargos atuais dos fluxos controladas.

virtual pos_type seekoff( 
   off_type _Off, 
   ios_base::seekdir _Way, 
   ios_base::openmode _Which = ios_base::in | ios_base::out 
);

Parâmetros

  • _Off
    A posição para buscar _Wayem relação a.

  • _Way
    O ponto de partida para operações de deslocamento. Consulte seekdir para valores possíveis.

  • _Which
    Especifica o modo da posição do ponteiro. A opção é permitir que você modifique a leitura e gravação posições.

Valor de retorno

Retorna a nova posição ou uma posição inválido de fluxo.

Comentários

Os esforços virtuais protegidos da função de membro alterar os cargos atuais dos fluxos controladas. Para um objeto da classe basic_filebuf<Elem, Tr>, uma posição do fluxo que pode ser representado por um objeto do tipo fpos_t, que armazena um deslocamento e quaisquer informações de estado necessários para analisar um fluxo todo o servidor. O deslocamento zero designa o primeiro elemento de fluxo. (Um objeto de repositório de pos_type do tipo pelo menos um objeto de fpos_t .)

Para um arquivo aberto para leitura e gravação, a entrada e os fluxos de saída são posicionados em tandem. Para alternar entre inserir e extrair, você deve chamar pubseekoff ou pubseekpos. As chamadas a pubseekoff (e portanto a seekoff) têm várias restrições para fluxos de texto, fluxos binários, e fluxos amplos.

Se o ponteiro de arquivo fp for um ponteiro nulo, a função falhará. Caso contrário, se esforça alterar a posição do fluxo chamando fseek(fp, _Off, _Way). Se a função for bem-sucedida e a posição fposn resultante pode ser determinada chamando fgetpos(fp, &fposn), a função tenha êxito. Se a função for bem-sucedida, retornará um valor do tipo pos_type que contém fposn. Caso contrário, retornará uma posição inválido de fluxo.

Requisitos

fstream <deCabeçalho: >

Namespace: std

Consulte também

Referência

Classe basic_filebuf

Programação iostream

Convenções iostreams