time_get::do_get_date

Artigo
06/09/2015

Uma função de membro virtual protegida que é chamada para analisar uma cadeia de caracteres como data gerada pelo especificador de x para strftime.

virtual iter_type do_get_date( 
   iter_type _First,  
   iter_type _Last, 
   ios_base& _Iosbase,  
   ios_base::iostate& _State,  
   tm* _Pt 
) const;

Parâmetros

_First
Iterador de entrada que trata o início da sequência a ser convertida.
_Last
Iterador de entrada que trata o término da sequência a ser convertida.
_Iosbase
Um sinalizador de formato que quando o conjunto indicar que o símbolo de moeda é opcional; caso contrário, é obrigatório.
_State
Define os elementos apropriados de máscara de bits do estado do fluxo de acordo com o que as operações foram bem-sucedidas.
_Pt
Um ponteiro para o qual as informações de data deve ser armazenada.

Valor de retorno

Um iterador de entrada que trata o primeiro elemento além de campo de entrada.

Comentários

A função de membro protegida virtual tenta corresponder aos elementos sequenciais começando primeiro na sequência [_First, _Last) até que reconheça um campo completo, não vazio de entrada de data. Se bem-sucedido, converte esse campo ao valor de equivalente como os componentes tm::tm_mon, tm::tm_day, e tm::tm_year, e armazena os resultados em _Pt->tm_mon, _Pt->tm_day e _Pt->tm_year, respectivamente. Retorna um iterador que designa o primeiro elemento além de campo de entrada de data. Caso contrário, a função define _Iosbase**::failbit** em _State. Retorna um iterador que designa o primeiro elemento além de qualquer prefixo de um campo de entrada válida de data. Em qualquer caso, se o valor de retorno é igual _Last, a função define ios_base::eofbit em _State.

O formato para o campo de entrada de data é dependente da localidade. Para a localidade padrão, o campo de entrada de datas tem DD do formulário MMM, AAAA, onde:

MMM são comparadas chamando get_monthname, dando o mês.
DD é uma sequência de dígitos decimais cujo valor numérico correspondente deve estar no intervalo de [1, 31], dando o dia do mês.
AAAA é correspondido chamando get_year, dando o ano.

Espaços e vírgulas do literal devem corresponder aos elementos correspondentes na sequência de entrada.

Exemplo

Consulte o exemplo de get_date, que chama do_get_date.

Requisitos

localidade <deCabeçalho: >

Namespace: std

Consulte também

Referência

Classe time_get

Compartilhar via