QDeadlineTimer Class

Documentación de la función miembro

Construye un objeto QDeadlineTimer caducado. Para este objeto, remainingTime() devolverá 0. Si timerType no está establecido, entonces el objeto utilizará el coarse timer type .

El tipo de temporizador timerType puede ser ignorado, ya que el temporizador ya ha expirado. Del mismo modo, por motivos de optimización, esta función no intentará obtener la hora actual y utilizará un valor que se sabe que está en el pasado. Por lo tanto, deadline() puede devolver un valor inesperado y este objeto no puede ser utilizado en el cálculo de cuánto tiempo está vencido. Si se requiere esa funcionalidad, utilice QDeadlineTimer::current().

Véase también hasExpired(), remainingTime(), Qt::TimerType, y current().

[constexpr noexcept] QDeadlineTimer::QDeadlineTimer(QDeadlineTimer::ForeverConstant, Qt::TimerType timerType = Qt::CoarseTimer)

Los objetos QDeadlineTimer creados con ForeverConstant nunca expiran. Para tales objetos, remainingTime() devolverá -1, deadline() devolverá el valor máximo, y isForever() devolverá true.

El tipo de temporizador timerType puede ser ignorado, ya que el temporizador nunca expirará.

Véase también ForeverConstant, hasExpired(), isForever(), remainingTime(), y timerType().

[explicit noexcept] QDeadlineTimer::QDeadlineTimer(qint64 msecs, Qt::TimerType type = Qt::CoarseTimer)

Construye un objeto QDeadlineTimer con un tiempo de expiración de msecs msecs desde el momento de la creación de este objeto, si msecs es positivo. Si msecs es cero, este QDeadlineTimer será marcado como expirado, causando que remainingTime() devuelva cero y deadline() devuelva un punto de tiempo indeterminado en el pasado. Si msecs es negativo, el temporizador se marcará como nunca expirado, causando que remainingTime() devuelva -1 y deadline() devuelva el valor máximo.

El objeto QDeadlineTimer se construirá con el temporizador especificado type.

Por motivos de optimización, si msecs es cero, esta función puede omitir la obtención de la hora actual y utilizar en su lugar un valor que se sabe que está en el pasado. Si eso ocurre, deadline() puede devolver un valor inesperado y este objeto no podrá ser utilizado para calcular cuánto tiempo está atrasado. Si se requiere esa funcionalidad, utilice QDeadlineTimer::current() y añádale el tiempo.

Ver también hasExpired(), isForever(), remainingTime(), y setRemainingTime().

template <typename Rep, typename Period> QDeadlineTimer::QDeadlineTimer(std::chrono::duration<Rep, Period> remaining, Qt::TimerType type = Qt::CoarseTimer)

Construye un objeto QDeadlineTimer con un tiempo restante de remaining. Si remaining es cero o negativo, este objeto QDeadlineTimer se marcará como caducado, mientras que si remaining es igual a duration::max(), el objeto se marcará como que nunca caduca.

El objeto QDeadlineTimer se construirá con el temporizador especificado type.

Este constructor se puede utilizar con los literales definidos por el usuario de C++14 para el tiempo, como in:

    using namespace std::chrono_literals;
    QDeadlineTimer deadline(250ms);

Por motivos de optimización, si remaining es cero o negativo, esta función puede omitir la obtención de la hora actual y utilizar en su lugar un valor que se sabe que está en el pasado. Si eso ocurre, deadline() puede devolver un valor inesperado y este objeto no puede ser utilizado en el cálculo del tiempo pasado. Si se requiere esa funcionalidad, utilice QDeadlineTimer::current() y añádale el tiempo.

Véase también hasExpired(), isForever(), remainingTime() y setRemainingTime().

template <typename Clock, typename Duration = typename Clock::duration> QDeadlineTimer::QDeadlineTimer(std::chrono::time_point<Clock, Duration> deadline, Qt::TimerType type = Qt::CoarseTimer)

Construye un objeto QDeadlineTimer con una fecha límite en el punto de tiempo deadline, convirtiendo desde la fuente de reloj Clock a la fuente de reloj interna de Qt (ver QElapsedTimer::clockType()).

Si deadline está en el pasado, este objeto QDeadlineTimer se establece como expirado, mientras que si deadline es igual a Duration::max(), entonces este objeto se establece como nunca expirado.

El objeto QDeadlineTimer se construirá con el temporizador especificado type.

Véase también hasExpired(), isForever(), remainingTime(), y setDeadline().

[static noexcept] QDeadlineTimer QDeadlineTimer::addNSecs(QDeadlineTimer dt, qint64 nsecs)

Devuelve un objeto QDeadlineTimer cuya fecha límite se extiende desde la fecha límite de dt en nsecs nanosegundos. Si dt fue configurado para no expirar nunca, esta función devuelve un QDeadlineTimer que tampoco expirará.

[static noexcept] QDeadlineTimer QDeadlineTimer::current(Qt::TimerType timerType = Qt::CoarseTimer)

Devuelve un QDeadlineTimer que está vencido pero se garantiza que contiene la hora actual. Los objetos creados por esta función pueden participar en el cálculo de cuánto tiempo está vencido un temporizador, utilizando la función deadline().

El objeto QDeadlineTimer se construirá con el timerType especificado.

[noexcept] qint64 QDeadlineTimer::deadline() const

Devuelve el punto de tiempo absoluto para la fecha límite almacenada en el objeto QDeadlineTimer, calculado en milisegundos relativos al reloj de referencia, igual que QElapsedTimer::msecsSinceReference(). El valor estará en el pasado si este QDeadlineTimer ha expirado.

Si este QDeadlineTimer nunca expira, esta función devuelve std::numeric_limits<qint64>::max().

Esta función se puede utilizar para calcular la cantidad de tiempo que un temporizador está vencido, restando QDeadlineTimer::current() o QElapsedTimer::msecsSinceReference(), como en el siguiente ejemplo:

    qint64 realTimeLeft = deadline.deadline();
    if (realTimeLeft != (std::numeric_limits<qint64>::max)()) {
        realTimeLeft -= QDeadlineTimer::current().deadline();
        // or:
        //QElapsedTimer timer;
        //timer.start();
        //realTimeLeft -= timer.msecsSinceReference();
    }

Véase también remainingTime(), deadlineNSecs() y setDeadline().

[noexcept] qint64 QDeadlineTimer::deadlineNSecs() const

Devuelve el punto de tiempo absoluto para la fecha límite almacenada en el objeto QDeadlineTimer, calculado en nanosegundos relativos al reloj de referencia, igual que QElapsedTimer::msecsSinceReference(). El valor estará en el pasado si este QDeadlineTimer ha expirado.

Si este QDeadlineTimer nunca expira o el número de nanosegundos hasta la fecha límite no puede ser acomodado en el tipo de retorno, esta función devuelve std::numeric_limits<qint64>::max().

Esta función se puede utilizar para calcular la cantidad de tiempo que un temporizador está vencido, restando QDeadlineTimer::current(), como en el siguiente ejemplo:

    qint64 realTimeLeft = deadline.deadlineNSecs();
    if (realTimeLeft != std::numeric_limits<qint64>::max())
        realTimeLeft -= QDeadlineTimer::current().deadlineNSecs();

Véase también remainingTime(), deadline() y setDeadline().

[noexcept] bool QDeadlineTimer::hasExpired() const

Devuelve true si este objeto QDeadlineTimer ha expirado, false si queda tiempo. Para los objetos que han expirado, remainingTime() devolverá cero y deadline() devolverá un punto de tiempo en el pasado.

QDeadlineTimer Los objetos creados con ForeverConstant nunca caducan y esta función siempre devuelve false para ellos.

Véase también isForever() y remainingTime().

[constexpr noexcept] bool QDeadlineTimer::isForever() const

Devuelve true si este objeto QDeadlineTimer nunca expira, false en caso contrario. Para los temporizadores que nunca expiran, remainingTime() siempre devuelve -1 y deadline() devuelve el valor máximo.

Véase también ForeverConstant, hasExpired(), y remainingTime().

[noexcept] qint64 QDeadlineTimer::remainingTime() const

Devuelve el tiempo restante en este objeto QDeadlineTimer en milisegundos. Si el temporizador ya ha expirado, esta función devolverá cero y no es posible obtener la cantidad de tiempo vencido con esta función (para ello, véase deadline()). Si el temporizador fue configurado para no expirar nunca, esta función devuelve -1.

Esta función es adecuada para su uso en APIs de Qt que toman un tiempo de espera de milisegundos, como las muchas funciones de QIODevice waitFor o las funciones de bloqueo temporizado en QMutex, QWaitCondition, QSemaphore, o QReadWriteLock. Por ejemplo:

    mutex.tryLock(deadline.remainingTime());

Véase también setRemainingTime(), remainingTimeNSecs(), isForever(), y hasExpired().

[noexcept] std::chrono::nanoseconds QDeadlineTimer::remainingTimeAsDuration() const

Devuelve el tiempo restante antes de la fecha límite.

[noexcept] qint64 QDeadlineTimer::remainingTimeNSecs() const

Devuelve el tiempo restante en este objeto QDeadlineTimer en nanosegundos. Si el temporizador ya ha expirado, esta función devolverá cero y no es posible obtener la cantidad de tiempo restante con esta función. Si el temporizador fue configurado para no expirar nunca, esta función devuelve -1.

Véase también remainingTime(), isForever(), y hasExpired().

[noexcept] void QDeadlineTimer::setDeadline(qint64 msecs, Qt::TimerType timerType = Qt::CoarseTimer)

Establece la fecha límite para este objeto QDeadlineTimer para que sea el punto de tiempo absoluto msecs, contado en milisegundos desde el reloj de referencia (el mismo que QElapsedTimer::msecsSinceReference()), y el tipo de temporizador a timerType. Si el valor está en el pasado, este QDeadlineTimer se marcará como expirado.

Si msecs es std::numeric_limits<qint64>::max() o el plazo está más allá de un punto representable en el futuro, este QDeadlineTimer se marcará como nunca expirado.

Véase también setPreciseDeadline(), deadline(), deadlineNSecs(), y setRemainingTime().

template <typename Clock, typename Duration = typename Clock::duration> void QDeadlineTimer::setDeadline(std::chrono::time_point<Clock, Duration> deadline, Qt::TimerType type = Qt::CoarseTimer)

Establece este QDeadlineTimer a la fecha límite marcada por el punto de tiempo deadline, convirtiendo de la fuente de reloj Clock a la fuente de reloj interna de Qt (ver QElapsedTimer::clockType()).

Si deadline está en el pasado, este objeto QDeadlineTimer se establece como expirado, mientras que si deadline es igual a Duration::max(), entonces este objeto se establece como nunca expirado.

El tipo de temporizador para este objeto QDeadlineTimer se establecerá en el especificado type.

Véase también hasExpired(), isForever(), y remainingTime().

[noexcept] void QDeadlineTimer::setPreciseDeadline(qint64 secs, qint64 nsecs = 0, Qt::TimerType timerType = Qt::CoarseTimer)

Establece el plazo para este objeto QDeadlineTimer en secs segundos y nsecs nanosegundos desde la época del reloj de referencia (igual que QElapsedTimer::msecsSinceReference()), y el tipo de temporizador en timerType. Si el valor está en el pasado, este QDeadlineTimer se marcará como caducado.

Si secs o nsecs es std::numeric_limits<qint64>::max(), este QDeadlineTimer se marcará como nunca expirado. Si nsecs es superior a mil millones de nanosegundos (1 segundo), entonces secs se ajustará en consecuencia.

Véase también setDeadline(), deadline(), deadlineNSecs(), y setRemainingTime().

[noexcept] void QDeadlineTimer::setPreciseRemainingTime(qint64 secs, qint64 nsecs = 0, Qt::TimerType timerType = Qt::CoarseTimer)

Establece el tiempo restante para este objeto QDeadlineTimer a secs segundos más nsecs nanosegundos a partir de ahora, si secs tiene un valor positivo. Si secs es negativo, este QDeadlineTimer se marcará como nunca expirado (este comportamiento no se aplica a nsecs). Si ambos parámetros son cero, este QDeadlineTimer se marcará como caducado.

Por motivos de optimización, si tanto secs como nsecs son cero, esta función puede omitir la obtención de la hora actual y utilizar en su lugar un valor que se sabe que está en el pasado. Si esto ocurre, deadline() puede devolver un valor inesperado y este objeto no podrá ser utilizado en el cálculo de cuánto tiempo está vencido. Si se requiere esa funcionalidad, utilice QDeadlineTimer::current() y añádale el tiempo.

El tipo de temporizador para este objeto QDeadlineTimer se establecerá en el especificado timerType.

Ver también setRemainingTime(), hasExpired(), isForever(), y remainingTime().

[noexcept] void QDeadlineTimer::setRemainingTime(qint64 msecs, Qt::TimerType timerType = Qt::CoarseTimer)

Establece el tiempo restante para este objeto QDeadlineTimer en msecs milisegundos a partir de ahora, si msecs tiene un valor positivo. Si msecs es cero, este objeto QDeadlineTimer se marcará como caducado, mientras que un valor negativo hará que no caduque nunca.

Por motivos de optimización, si msecs es cero, esta función puede omitir la obtención de la hora actual y utilizar en su lugar un valor que se sabe que está en el pasado. Si esto ocurre, deadline() puede devolver un valor inesperado y este objeto no podrá ser utilizado en el cálculo de cuánto tiempo está vencido. Si se requiere esa funcionalidad, utilice QDeadlineTimer::current() y añádale el tiempo.

El tipo de temporizador para este objeto QDeadlineTimer se establecerá en el especificado timerType.

Ver también setPreciseRemainingTime(), hasExpired(), isForever(), y remainingTime().

template <typename Rep, typename Period> void QDeadlineTimer::setRemainingTime(std::chrono::duration<Rep, Period> remaining, Qt::TimerType type = Qt::CoarseTimer)

Establece el tiempo restante para este objeto QDeadlineTimer en remaining. Si remaining es cero o negativo, este objeto QDeadlineTimer se marcará como caducado, mientras que si remaining es igual a duration::max(), el objeto se establecerá como que nunca caduca.

El tipo de temporizador para este objeto QDeadlineTimer se establecerá en el especificado type.

Esta función se puede utilizar con los literales definidos por el usuario de C++14 para el tiempo, como in:

    using namespace std::chrono_literals;
    deadline.setRemainingTime(250ms);

Ver también setDeadline(), remainingTime(), hasExpired(), y isForever().

void QDeadlineTimer::setTimerType(Qt::TimerType timerType)

Cambia el tipo de temporizador de este objeto a timerType.

El comportamiento para cada posible valor de timerType depende del sistema operativo. Qt::PreciseTimer utilizará el temporizador más preciso que Qt pueda encontrar, con una resolución de 1 milisegundo o mejor, mientras que QDeadlineTimer intentará utilizar un temporizador más grueso para Qt::CoarseTimer y Qt::VeryCoarseTimer.

Véase también timerType() y Qt::TimerType.

[noexcept] void QDeadlineTimer::swap(QDeadlineTimer &other)

Cambia este temporizador de fecha límite por other. Esta operación es muy rápida y nunca falla.

[noexcept] Qt::TimerType QDeadlineTimer::timerType() const

Devuelve el tipo de temporizador está activo para este objeto.

Véase también setTimerType().

QDeadlineTimer &QDeadlineTimer::operator+=(qint64 msecs)

Prolonga este objeto QDeadlineTimer en msecs milisegundos y se devuelve a sí mismo. Si este objeto está configurado para no expirar nunca, esta función no hace nada.

Para añadir tiempos de precisión superiores a 1 milisegundo, utilice addNSecs().

QDeadlineTimer &QDeadlineTimer::operator-=(qint64 msecs)

Acorta este objeto QDeadlineTimer en msecs milisegundos y se devuelve a sí mismo. Si este objeto está configurado para no expirar nunca, esta función no hace nada.

Para restar tiempos de precisión superiores a 1 milisegundo, utilice addNSecs().

template <typename Rep, typename Period> QDeadlineTimer &QDeadlineTimer::operator=(std::chrono::duration<Rep, Period> remaining)

Establece este temporizador de fecha límite a la hora remaining.

template <typename Clock, typename Duration = typename Clock::duration> QDeadlineTimer &QDeadlineTimer::operator=(std::chrono::time_point<Clock, Duration> deadline_)

Asigna deadline_ a este temporizador de plazo.