basic_stringbuf::seekoff

Artigo
06/09/2015

As tentativas virtuais protegidas da função de membro para alterar os cargos atuais dos fluxos controladas.

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

Parâmetros

_Off
A posição para buscar _Wayem relação a. Para obter mais informações, consulte basic_stringbuf::off_type.
_Way
O ponto de partida para operações de deslocamento. Consulte ios_base::seekdir para valores possíveis.
_Mode
Especifica o modo da posição do ponteiro. A opção é permitir que você modifique a leitura e gravação posições. Para obter mais informações, consulte ios_base::openmode.

Valor de retorno

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

Comentários

Para um objeto da classe basic_stringbuf<Elem, Tr, Alloc>, uma posição de fluxo consiste apenas em um deslocamento do fluxo. O deslocamento zero designa o primeiro elemento da sequência controlada.

A nova posição é determinado da seguinte maneira:

Se o ios_base::beg== de _Way , a nova posição será o início do fluxo mais _Off.
Se o ios_base::cur== de _Way , a nova posição é a posição atual do fluxo mais _Off.
Se o ios_base::end== de _Way , a nova posição é o final do fluxo mais _Off.

Se _Mode & ios_base::in for diferente de zero, a função altera a próxima posição ler no buffer de entrada. Se _Mode & ios_base::out for diferente de zero, a função altera a próxima posição gravar no buffer de saída. Para que um fluxo é afetado, seu buffer deve existir. Para que uma operação de posicionamento tenha êxito, a posição resultante de fluxo deve ficar dentro da sequência controlada. Se a função afeta ambas passam posições, _Way deve ser ios_base::beg ou ios_base::end e os fluxos são localizados no mesmo elemento. Se não (ou se nenhuma posição é afetada), a operação de posicionamento falha.

Se a função tiver êxito na alteração de qualquer uma ou ambas as posições de fluxo, retorna a posição resultante de fluxo. Se não, falhará e retornará uma posição inválido de fluxo.