QElapsedTimer Class

Documentación de las funciones miembro

[constexpr noexcept] QElapsedTimer::QElapsedTimer()

Construye un QElapsedTimer inválido. Un temporizador pasa a ser válido una vez que se ha iniciado.

Véase también isValid() y start().

[static noexcept] QElapsedTimer::ClockType QElapsedTimer::clockType()

Devuelve el tipo de reloj que utiliza esta implementación de QElapsedTimer.

Desde Qt 6.6, QElapsedTimer utiliza std::chrono::steady_clock, por lo que el tipo de reloj es siempre MonotonicClock.

Véase también isMonotonic().

[noexcept, since 6.6] QElapsedTimer::Duration QElapsedTimer::durationElapsed() const

Devuelve un std::chrono::nanoseconds con la hora desde que este QElapsedTimer se inició por última vez.

Llamar a esta función en un QElapsedTimer que no es válido resulta en un comportamiento indefinido.

En plataformas que no proporcionan resolución de nanosegundos, el valor devuelto será la mejor estimación disponible.

Esta función se introdujo en Qt 6.6.

Véase también start(), restart(), hasExpired() y invalidate().

[noexcept, since 6.6] QElapsedTimer::Duration QElapsedTimer::durationTo(const QElapsedTimer &other) const

Devuelve la diferencia de tiempo entre este QElapsedTimer y other como std::chrono::nanoseconds. Si other se inició antes que este objeto, el valor devuelto será negativo. Si se inició más tarde, el valor devuelto será positivo.

El valor devuelto es indefinido si este objeto o other fueron invalidados.

Esta función se introdujo en Qt 6.6.

Véase también secsTo() y elapsed().

[noexcept] qint64 QElapsedTimer::elapsed() const

Devuelve el número de milisegundos transcurridos desde que este QElapsedTimer se inició por última vez.

Llamar a esta función en un QElapsedTimer que no es válido resulta en un comportamiento indefinido.

Véase también start(), restart(), hasExpired(), isValid() y invalidate().

[noexcept] bool QElapsedTimer::hasExpired(qint64 timeout) const

Devuelve true si elapsed() supera el valor dado timeout, en caso contrario false.

Un timeout negativo se interpreta como infinito, por lo que se devuelve false en este caso. De lo contrario, es equivalente a elapsed() > timeout. Puede hacer lo mismo para una duración comparando durationElapsed() con un tiempo de espera de duración.

Véase también elapsed() y QDeadlineTimer.

[noexcept] void QElapsedTimer::invalidate()

Marca este objeto QElapsedTimer como no válido.

Un objeto inválido puede comprobarse con isValid(). Los cálculos del tiempo transcurrido desde los datos inválidos no están definidos y probablemente producirán resultados extraños.

Véase también isValid(), start(), y restart().

[static noexcept] bool QElapsedTimer::isMonotonic()

Devuelve true si se trata de un reloj monotónico, false en caso contrario. Vea la información sobre los diferentes tipos de reloj para entender cuáles son monotónicos.

Desde Qt 6.6, QElapsedTimer utiliza std::chrono::steady_clock, por lo que esta función ahora siempre devuelve true.

Véase también clockType() y QElapsedTimer::ClockType.

[noexcept] bool QElapsedTimer::isValid() const

Devuelve false si el temporizador nunca ha sido iniciado o invalidado por una llamada a invalidate().

Véase también invalidate(), start() y restart().

[noexcept] qint64 QElapsedTimer::msecsSinceReference() const

Devuelve el número de milisegundos entre la última vez que se inició este objeto QElapsedTimer y el inicio de su reloj de referencia.

Este número suele ser arbitrario para todos los relojes excepto para el reloj QElapsedTimer::SystemTime. Para ese tipo de reloj, este número es el número de milisegundos desde el 1 de enero de 1970 a las 0:00 UTC (es decir, es la hora Unix expresada en milisegundos).

En las plataformas Linux, Windows y Apple, este valor suele ser el tiempo transcurrido desde el arranque del sistema, aunque normalmente no incluye el tiempo que el sistema ha pasado en estados de reposo.

Véase también clockType() y elapsed().

[noexcept] qint64 QElapsedTimer::msecsTo(const QElapsedTimer &other) const

Devuelve el número de milisegundos entre este QElapsedTimer y other. Si other se inició antes que este objeto, el valor devuelto será negativo. Si se inició después, el valor devuelto será positivo.

El valor devuelto es indefinido si este objeto o other fueron invalidados.

Véase también secsTo() y elapsed().

[noexcept] qint64 QElapsedTimer::nsecsElapsed() const

Devuelve el número de nanosegundos transcurridos desde el último inicio de QElapsedTimer.

Llamar a esta función en un QElapsedTimer que no es válido resulta en un comportamiento indefinido.

En plataformas que no proporcionan resolución de nanosegundos, el valor devuelto será la mejor estimación disponible.

Véase también start(), restart(), hasExpired() y invalidate().

[noexcept] qint64 QElapsedTimer::restart()

Reinicia el temporizador y devuelve el número de milisegundos transcurridos desde el inicio anterior. Esta función es equivalente a obtener el tiempo transcurrido con elapsed() y luego iniciar de nuevo el temporizador con start(), pero lo hace en una sola operación, evitando la necesidad de obtener el valor del reloj dos veces.

Llamar a esta función en un QElapsedTimer que no es válido resulta en un comportamiento indefinido.

El siguiente ejemplo ilustra cómo utilizar esta función para calibrar un parámetro de una operación lenta (por ejemplo, un recuento de iteraciones) para que esta operación tarde al menos 250 milisegundos:

    QElapsedTimer timer;

    int count = 1;
    timer.start();
    do {
        count *= 2;
        slowOperation2(count);
    } while (timer.restart() < 250);

    return count;

Véase también start(), invalidate(), elapsed() y isValid().

[noexcept] qint64 QElapsedTimer::secsTo(const QElapsedTimer &other) const

Devuelve el número de segundos entre este QElapsedTimer y other. Si other se inició antes que este objeto, el valor devuelto será negativo. Si se inició más tarde, el valor devuelto será positivo.

Llamar a esta función en o con un QElapsedTimer que no es válido resulta en un comportamiento indefinido.

Véase también msecsTo() y elapsed().

[noexcept] void QElapsedTimer::start()

Inicia este temporizador. Una vez iniciado, el valor del temporizador puede comprobarse con elapsed() o msecsSinceReference().

Normalmente, un temporizador se inicia justo antes de una operación larga, como:

    QElapsedTimer timer; timer.start();
    slowOperation1();

    qDebug() << "The slow operation took" << timer.elapsed() << "milliseconds";

Además, si se inicia un temporizador, vuelve a ser válido.

Véase también restart(), invalidate() y elapsed().