time_put::put

Article
06/09/2015

Génère les informations de date et d'heure sous la forme d'une séquence de CharTypeS.

iter_type put( 
   iter_type _Next,  
   ios_base& _Iosbase, 
   char_type _Fill,  
   const tm* _Pt,  
   char _Fmt,  
   char _Mod = 0 
) const; 
iter_type put( 
   iter_type _Next,  
   ios_base& _Iosbase, 
   char_type _Fill,  
   const tm* _Pt, 
   const CharType* _First,  
   const CharType* _Last 
) const;

Paramètres

_Next
Un itérateur de sortie de la séquence de caractères représentant la date et l'heure doivent être insérées.
_Iosbase
Non utilisé.
_Fill
Le caractère du type CharType utilisé pour espacer.
_Pt
Les informations de date et d'heure sont générées.
_Fmt
Le format de sortie. Consultez strftime, wcsftime, _strftime_l, _wcsftime_l des valeurs valides.
_Mod
Un modificateur du format. Consultez strftime, wcsftime, _strftime_l, _wcsftime_l des valeurs valides.
_First
Le début de la chaîne de mise en forme de la sortie. Consultez strftime, wcsftime, _strftime_l, _wcsftime_l des valeurs valides.
_Last
La fin de la chaîne de mise en forme de la sortie. Consultez strftime, wcsftime, _strftime_l, _wcsftime_l des valeurs valides.

Valeur de retour

Un itérateur à la première position qui suit le dernier élément inséré.

Notes

La première fonction membre retourne do_put(_Next, _Iosbase, _Fill, _Pt, _Fmt, _Mod). La deuxième fonction membre copie *_Next ++ un élément dans l'intervalle [_First, _Last) autre que pourcentage (%). Pour un pourcentage suivi d'un caractère c c dans l'intervalle [_First, _Last), la fonction évalue à la place _Next = do_put(_Next, _Iosbase, _Fill, _Pt, c c, 0) et les sauts après L'aide De c. Si, en revanche, l'Assistant aide De c est un caractère qualificateur de l'ensemble EOQ#, suivi d'un caractère C2 dans l'intervalle [_First, _Last), la fonction évalue à la place _Next = do_put(_Next, _Iosbase, _Fill, _Pt, C2, *C)*et les sauts après C2.

Exemple

// time_put_put.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
#include <sstream>
#include <time.h>
using namespace std;
int main( )
{
   locale loc;
   basic_stringstream<char> pszPutI;
   ios_base::iostate st = 0;
   struct tm t;
   memset( &t, 0, sizeof( struct tm ) );

   t.tm_hour = 5;
   t.tm_min = 30;
   t.tm_sec = 40;
   t.tm_year = 00;
   t.tm_mday = 4;
   t.tm_mon = 6;

   pszPutI.imbue( loc );
   char *pattern = "x: %X %x";
   use_facet <time_put <char> >
   (loc).put(basic_ostream<char>::_Iter(pszPutI.rdbuf( )),
          pszPutI, ' ', &t, pattern, pattern+strlen(pattern));

      cout << "num_put( ) = " << pszPutI.rdbuf( )->str( ) << endl;

      char strftimebuf[255];
      strftime(&strftimebuf[0], 255, pattern, &t);
      cout << "strftime( ) = " << &strftimebuf[0] << endl;
}

Configuration requise

**En-tête :**paramètres régionaux <de >

Espace de noms : std

Voir aussi

Référence

time_put, classe

Partager via