time_put::put

Article
03/04/2013

Affiche 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 où 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 de type CharType utilisé pour l'espacement.
_Pt
Les informations de date et d'heure en cours de sorties.
_Fmt
Le format de sortie.Consultez strftime, wcsftime, _strftime_l, _wcsftime_l pour les valeurs valides.
_Mod
Un modificateur dans le format.Consultez strftime, wcsftime, _strftime_l, _wcsftime_l pour les valeurs valides.
_First
Le début de la chaîne de mise en forme de la sortie.Consultez strftime, wcsftime, _strftime_l, _wcsftime_l pour les valeurs valides.
_Last
La fin de la chaîne de mise en forme de la sortie.Consultez strftime, wcsftime, _strftime_l, _wcsftime_l pour les valeurs valides.

Valeur de retour

Un itérateur à la première position après 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 C++ n'importe quel élément dans la plage [_First, _Last) autre qu'un pourcentage (%).Pour un pourcentage suivi d'un caractère C dans la plage [_First, _Last), la fonction prend la place _Next = do_put(_Next, _Iosbase, _Fill, _Pt, C, 0) et ignore au delà de *C.*Si, toutefois, C' est un caractère de qualificateur du jeu EOQ#, suivi d'un caractère C2 dans la plage [_First, _Last), la fonction prend la place _Next = do_put(_Next, _Iosbase, _Fill, _Pt, C2, *C)*et ignore au delà de 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 : <locale>

l'espace de noms : DST

Voir aussi

Référence

time_put Class

Partager via