start_sectimer()

start_sectimer() initializes a timer by adding the specified number of seconds to the current system time and returns the future timestamp.

C

Prototype

time_t start_sectimer(time_t seconds);

Parameters

Key	Type	Description
seconds	time_t	The number of seconds to add to the current system time.

---

Return Value

Returns a time_t value representing the future timestamp when the timer will expire.

Notes

[‘Use test_sectimer() to check if the timer has expired.’, ‘If seconds is less than or equal to zero, the function still returns the current time.’]

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python

Examples

C

// TODO C examples

JS

// TODO JS examples

Python

# TODO Python examples