Biblioteca iomanip de C ++ - función put_time

Descripción

Esta función accede a la secuencia de salida construyendo primero un objeto de tipo basic_ostream :: sentry. Luego (si la evaluación del objeto centinela es verdadera), llama a time_put :: put (usando la configuración regional seleccionada de la secuencia) para realizar tanto el formateo como las operaciones de inserción, ajustando los indicadores de estado internos de la secuencia en consecuencia. Finalmente, destruye el objeto centinela antes de regresar.

Se utiliza para insertar la representación de la información de fecha y hora señalada por tmb, formateándola como se especifica en el argumento fmt.

Declaración

A continuación se muestra la declaración de la función std :: put_time.

template <class charT>
/*unspecified*/ put_time (const struct tm* tmb, const charT* fmt);

Parámetros

tmb- Puntero al objeto de tipo struct tm con la información de fecha y hora a formatear. struct tm es una clase definida en el encabezado <ctime>.

fmt- Cadena C utilizada por time_put :: poner como cadena de formato. Contiene cualquier combinación de caracteres regulares y especificadores de formato especial. Estos especificadores de formato son reemplazados por la función a los valores correspondientes para representar el tiempo especificado en tmb.

Todos comienzan con un signo de porcentaje (%) y se muestran a continuación:

Valor devuelto

Sin especificar. Esta función solo debe usarse como manipulador de flujo.

Los errores se señalan modificando los indicadores de estado internos de la transmisión:

Excepciones

Basic guarantee - si se lanza una excepción, el objeto está en un estado válido.

Lanza una excepción de falla de tipo de miembro si la marca de estado de error resultante no es goodbit y las excepciones de miembro se establecieron para lanzar para ese estado.

Cualquier excepción lanzada por una operación interna es capturada y manejada por la función, configurando badbit. Si badbit se estableció en la última llamada a excepciones, la función vuelve a generar la excepción detectada.

Carreras de datos

Accede al objeto apuntado por tmb y la matriz apuntada por fmt.

Modifica el objeto de flujo donde se inserta.

El acceso simultáneo al mismo objeto de transmisión puede causar carreras de datos, excepto para los objetos de transmisión estándar (cout, cerr, clog, wcout, wcerr y wclog) cuando estos están sincronizados con stdio (en este caso, no se inician carreras de datos, aunque no las garantías se dan en el orden en que se insertan los caracteres de varios hilos).

Ejemplo

En el siguiente ejemplo se explica la función put_time.

#include <iostream>
#include <iomanip>
#include <ctime>
#include <chrono>

int main () {
   using std::chrono::system_clock;
   std::time_t tt = system_clock::to_time_t (system_clock::now());

   struct std::tm * ptm = std::localtime(&tt);
   std::cout << "Now (local time): " << std::put_time(ptm,"%c") << '\n';

   return 0;
}