Clase duration

Mide un intervalo de tiempo, como un minuto, dos horas, diez milisegundos, etc.

La clase duration contiene un intervalo de tiempo, que es el número de tics en una unidad de tiempo. Por ejemplo, cinco minutos son cinco ciclos, los cuales están separados entre sí por intervalos de minuto. 42 segundos son 42 ciclos, los cuales están separados entre sí por intervalos de un segundo.

Sintaxis

template <class Rep, class Period> class duration;
template <class Rep, class Period = ratio<1>> class duration;
template <class Rep, class Period1, class Period2> class duration <duration<Rep, Period1>, Period2>;

Comentarios

El argumento de plantilla Rep describe el tipo que se utiliza para almacenar el número de ciclos de reloj del intervalo. El argumento de plantilla Period es una creación de instancias de ratio que describe el tamaño del intervalo que representa cada ciclo.

Miembros

Constructores

Nombre	Descripción
duration	Construye un objeto duration.

Funciones

Nombre	Descripción
count	Devuelve el número de pasos del reloj del intervalo de tiempo.
max	Estática. Devuelve el valor máximo permitido del parámetro de plantilla Rep.
min	Estática. Devuelve el valor mínimo permitido del parámetro de plantilla Rep.
zero	Estática. En efecto, devuelve Rep(0).

Operadores

Nombre	Descripción
duration::operator-	Devuelve una copia del objeto duration con un contador negado.
duration::operator--	Disminuye el recuento de pasos almacenado.
duration::operator-=	Resta el contador de un objeto duration especificado del contador almacenado.
duration::operator+	Devuelve *this.
duration::operator++	Incrementa el recuento de pasos almacenado.
duration::operator+=	Suma el contador de un objeto duration especificado al contador almacenado.
duration::operator=	Asigna una duración a otra.
duration::operator*=	Multiplica el recuento de pasos almacenado por un valor especificado.
duration::operator/=	Divide el recuento de pasos almacenado por el recuento de pasos de un objeto duration especificado.
duration::operator%=	Reduce el módulo del recuento de pasos almacenado en un valor especificado.

No miembros

Plantillas de función

Nombre	Descripción
abs	Devuelve el valor absoluto de duration.
ceil	Devuelve el elemento duration más pequeño que se puede representar que es mayor o igual que el elemento duration especificado.
duration_cast	Convierte un objeto duration a un tipo duration de destino.
floor	Devuelve el elemento duration más grande que se puede representar que es menor o igual que el elemento duration especificado.
from_stream	Analiza un duration desde la secuencia especificada con el formato indicado.
round	Redondea el elemento duration especificado al elemento duration más cercano que se puede representar en el tipo de destino.

Operadores

Nombre	Descripción
operator+	Después de convertir las duraciones que se agregan a su tipo común, devuelve un elemento duration con un contador igual a la suma de los contadores convertidos.
operator-	Después de convertir las duraciones que se restan a su tipo común, devuelve un elemento duration con un contador igual al número de ciclos del elemento duration RHS restado del número de ciclos del elemento duration LHS.
operator*	Después de convertir las duraciones que se multiplican a su tipo común, devuelve un elemento duration con un contador igual a la multiplicación de los contadores convertidos.
operator/	Después de convertir las duraciones que se dividen a su tipo común, devuelve un elemento duration con un contador igual a la división de los contadores convertidos.
operator%	Después de convertir el elemento duration y el divisor a su tipo común, devuelve un elemento duration con un contador igual al resto de la división.
operator==	Después de convertir los tipos duration que se comparan con su tipo común, determina si el número de ciclos es igual.
operator!=	Determina si el elemento duration no es igual a otro.
operator<	Determina si un elemento duration es menor que otro.
operator<=	Determina si un elemento duration es menor o igual que otro.
operator>	Determina si un elemento duration es mayor que otro.
operator>=	Determina si un elemento duration es mayor o igual que otro.
operator<=>	Compara un elemento duration con otro elemento duration. El compilador sintetiza los operadores >, >=, <=, <, !=.
operator<<	Genera un elemento duration en la secuencia especificada.

Alias de tipo de conveniencia

Nombre	Descripción
duration::period	Sinónimo del parámetro de plantilla Period.
duration::rep	Sinónimo del parámetro de plantilla Rep.

Requisitos

Encabezado: <chrono>

Espacio de nombres: std::chrono

duration::count

Recupera el número de ciclos del reloj del intervalo de tiempo.

constexpr Rep count() const;

Valor devuelto

Número de ciclos del reloj del intervalo de tiempo.

Constructor duration::duration

Construye un objeto duration.

1) constexpr duration() = default;
2) constexpr duration(const duration& d) = default;

3) template <class Rep2>
constexpr explicit duration(const Rep2& R);

4) template <class Rep2, class Period2>
constexpr duration(const duration<Rep2, Period2>& Dur);

Parámetros

Dur
El número de ciclos del período especificado por Period2.

Period2
Una especialización de plantilla std::ratio para representar el período de ciclo en unidades de segundos.

R
El número de ciclos del período predeterminado.

Rep2
Un tipo aritmético para representar el número de ciclos.

Comentarios

1) El constructor predeterminado crea un objeto que no se ha inicializado. La inicialización de un valor mediante llaves vacías inicializa un objeto que representa un intervalo de tiempo de cero ciclos de reloj.

2) El constructor de copia realiza una copia bit a bit de d.

3) Crea un objeto que representa un intervalo de tiempo de R ciclos de reloj con un período predeterminado de std::ratio<1>. Para evitar el redondeo de los contadores, es un error construir un objeto de duración a partir de un tipo de representación Rep2 que se puede tratar como un tipo de punto flotante cuando duration::rep no se puede tratar como un tipo de punto flotante.

4) Crea un objeto que representa un intervalo de tiempo cuya longitud es el intervalo de tiempo especificado por Dur. Para evitar el truncamiento de los contadores, es un error construir un objeto de duración a partir de otro objeto de duración cuyo tipo es inconmensurable con el tipo de destino.

Un tipo de duración D1 es inconmensurable con otro tipo de duración D2 si D2 no se puede tratar como un tipo de punto flotante y ratio_divide<D1::period, D2::period>::type::den no es 1.

A menos que Rep2 sea convertible de forma implícita a rep y treat_as_floating_point<rep> sea True o treat_as_floating_point<Rep2> sea False, el segundo constructor no participa en la resolución de sobrecarga. Para obtener más información, consulte <type_traits>.

A menos que no se induzca ningún desbordamiento en la conversión y treat_as_floating_point<rep> sea True, o ratio_divide<Period2, period>::den sea igual a 1 y treat_as_floating_point<Rep2> sea False, el tercer constructor no participa en la resolución de sobrecarga. Para obtener más información, consulte <type_traits>.

Ejemplo: Creación de un objeto duration

// compile using: /std:c++latest
#include <iostream>
#include <chrono>

using namespace std::chrono;

int main()
{
    // create a duration that tracks ticks as 1/10ths of a second
    duration<int, std::ratio<1, 10>> tenths{ 5 };
    std::cout << tenths << '\n';

    hours h{12}; // hours is a convenience duration typedef 
    auto h2 = 3h; // 'h' is a convenience operator. h2 is a duration<int, std::ratio<3600,1>>

    std::cout << h << ":" << h2 << '\n';

    return 0;
}

5ds
3h:3h

duration::max

Método estático que devuelve el límite superior para los valores de tipo de parámetro de plantilla Rep.

static constexpr duration max();

Valor devuelto

En efecto, devuelve duration(duration_values<rep>::max()).

duration::min

Método estático que devuelve el límite inferior para los valores de tipo de parámetro de plantilla Rep.

static constexpr duration min();

Valor devuelto

En efecto, devuelve duration(duration_values<rep>::min()).

duration::operator-

Devuelve una copia del objeto duration con un contador negado.

constexpr duration operator-() const;

duration::operator--

Disminuye el recuento de pasos almacenado.

1) duration& operator--();
2) duration operator--(int);

Valor devuelto

1) Devuelve *this. 2) Devuelve una copia de *this antes del decremento.

duration::operator%=

Reduce el módulo del contador almacenado en el valor especificado.

1) duration& operator%=(const rep& Div);
2) duration& operator%=(const duration& Div);

Parámetros

Div
1) Realiza una operación Div en un contador. 2) Realiza una operación Div en un elemento duration que contiene un contador.

Valor devuelto

El objeto duration después de realizarse la operación de módulo.

duration::operator*=

Multiplica el recuento de pasos almacenado por un valor especificado.

duration& operator*=(const rep& Mult);

Parámetros

Mult
Valor del tipo especificado por duration::rep.

Valor devuelto

El objeto duration después del cual se realiza la multiplicación.

duration::operator/=

Divide el recuento de pasos almacenado por un valor especificado.

duration& operator/=(const rep& Div);

Parámetros

Div
Valor del tipo especificado por duration::rep.

Valor devuelto

El objeto duration después del cual se realiza la división.

duration::operator+

Devuelve *this.

constexpr duration operator+() const;

Valor devuelto

*this

duration::operator++

Incrementa el recuento de pasos almacenado.

1) duration& operator++();
2) duration operator++(int);

Valor devuelto

1) Devuelve *this. 2) Devuelve una copia de *this antes del incremento.

duration::operator+=

Suma el recuento de pasos de un objeto duration especificado al recuento de pasos almacenado.

duration& operator+=(const duration& Dur);

Parámetros

Dur
Un objeto duration.

Valor devuelto

El objeto duration después de realizar la suma.

duration::operator-=

Resta el recuento de pasos de un objeto duration especificado del recuento de pasos almacenado.

duration& operator-=(const duration& Dur);

Parámetros

Dur
Un objeto duration.

Valor devuelto

El objeto duration después de realizar la resta.

duration::zero

Devuelve duration(duration_values<rep>::zero()).

static constexpr duration zero();

duration::operator=

Asigna una duración a otra.

duration& operator=(const duration &other) = default;

Parámetros

other
El objeto duration que se va a copiar.

Valor devuelto

El objeto duration LHS.

Consulte también

<chrono>
Definiciones de tipos duration de conveniencia, como minutes, seconds y más
Literales de conveniencia para horas, minutos y más
Estructura duration_values
Referencia de archivos de encabezado