Compartilhar via


codecvt::do_unshift

Uma função virtual chamada para fornecer Bytes necessários em uma conversão de valores dependentes de concluir o último caractere em uma sequência de ByteS.

virtual result do_unshift(
    StateType& _State,
    Byte* _First2, 
    Byte* _Last2, 
    Byte*& _Next2
) const;

Parâmetros

  • _State
    O estado da conversão que é mantido entre chamadas para a função de membro.

  • _First2
    Ponteiro para a primeira posição no intervalo de destino.

  • _Last2
    Ponteiro para a última posição no intervalo de destino.

  • _Next2
    Ponteiro para o primeiro elemento inalterado na sequência de destino.

Valor de retorno

A função retornará:

  • codecvt_base::error se _State representa um estado inválido

  • codecvt_base::noconv se a função não executa nenhuma conversão

  • codecvt_base::ok se a conversão for bem-sucedida

  • codecvt_base::partial se o destino não seja grande o suficiente para que a conversão tenha êxito

Comentários

As tentativas virtuais protegidas da função de membro para converter o elemento CharTypede origem (0) para uma sequência de destino de que armazena em [_First2, _Last2), com exceção do elemento de encerramento Byte(0). Armazena sempre em _Next2 um ponteiro para o primeiro elemento inalterado na sequência de destino.

_State deve representar o estado inicial de conversão no início de uma nova sequência de origem. A função altera seu valor armazenado conforme necessário para refletir o estado atual de uma conversão bem-sucedida. Normalmente, converta o elemento CharTypede origem (0) deixar o estado atual no estado inicial de conversão.

Exemplo

Consulte o exemplo de unshift, que chama do_unshift.

Requisitos

localidade <deCabeçalho: >

Namespace: std

Consulte também

Referência

Classe codecvt