La función ts_last_valid()

La función ts_last_valid() extrae la entrada para un punto temporal determinado.

Sintaxis

ts_tselem
ts_last_valid(ts_tsdesc   *tsdesc,
               mi_datetime *tstamp,
               mi_integer  *STATUS,
               mi_integer  *off)

tsdesc

El descriptor para una serie de tiempo devuelto por ts_open().

tstamp

La indicación de fecha y hora de interés.

STATUS

Un puntero a un valor mi_integer. Consulte La función ts_hide_elem() para obtener una descripción de STATUS.

off

Si la serie de tiempo es regular, off se establece en el desplazamiento del elemento devuelto. Si la serie de tiempo es irregular, o si se encuentra vacía, off se establece en -1. Este argumento puede pasarse como NULL.

Descripción

Para series de tiempo regulares, esta función devuelve el primer elemento con una indicación de fecha y hora menor o igual a tstamp. Para series de tiempo irregulares, devuelve el último elemento en o antes de la indicación de fecha y hora determinada.

Devuelve

El elemento más cercano en o antes de la indicación de fecha y hora determinada. Si no existe dicho elemento antes de la indicación de fecha y hora, se devuelve un valor NULL.

El llamante no deberá liberar este elemento. Sigue siendo válido hasta que se capte el elemento siguiente del descriptor.