Compartilhar via


codecvt::do_length

Uma função virtual que determina por quanto Bytes de uma sequência do produto externo de Bytes não mais do que um determinado número de CharTypeinterno s e retorna o número de ByteS.

virtual int do_length(
    const StateType& _State,
    const Byte* _First1, 
    const Byte* _Last1,
    size_t _Len2
) const;

Parâmetros

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

  • _First1
    Ponteiro para o início da sequência externo.

  • _Last1
    Ponteiro para o término da sequência externo.

  • _Len2
    O número máximo de Bytes que pode ser retornado pela função de membro.

Valor de retorno

Um inteiro que representa uma contagem do número máximo de conversões, não for maior do que _Len2, definido pela sequência de origem externa em [_First1, _Last1).

Comentários

A função de membro virtual protegida chama efetivamente do_in(_State, _First1, _Last1, _Next1, _Buf, _Buf + _Len2, _Next2) para _State (uma cópia do estado), alguns armazena em buffer _Buf, e ponteiros _Next1e _Next2.

Retorna o _Next2 – buf. Assim, conta o número máximo de conversões, não for maior do que _Len2, definido pela sequência de origem em [_First1, _Last1).

A versão do modelo sempre retorna o menor de _Last1 – de _First1 e de _Len2.

Exemplo

Consulte o exemplo de comprimento, que chama do_length.

Requisitos

localidade <deCabeçalho: >

Namespace: std

Consulte também

Referência

Classe codecvt