# read

The keyword is used to to retrieve the time that has elapsed since the specified timer was started. The returned value is of type float.

- Applying the read operation to an inactive timer will return the float value zero (0.0).

Related keywords:

- running
- timer
- start
- stop
- timeout

### timer_identifier.read;

- timer_identifier is the name used to refer to the timer. It must begin with a letter, may contain letters, numbers and underscore characters.

It is possible to read a member of a timer array.

### timer_identifier[array_index].read;

- timer_identifier is the name used to refer to the timer. It must begin with a letter, may contain letters, numbers and underscore characters.

- array_index points out the timer to be read.

Example 1:

var float vl_flottant := T_porslin.read;

The local variable vl_flottant is defined and used to store the time elapsed since the start of the global timer T_porslin.

Example 2:

var float v_ile := Tl_Rochereau[7].read;

The variable v_ile is defined and used to store the time elapsed since the start of the eighth timer of the array T_Rochereau.

BNF definition of read