Ranges Information

int roctxRangePushA(const char *message)

Start a new nested range.

Nested ranges are stacked and local to the current CPU thread.

Parameters:

message – [in] The message associated with this range.

Returns:

Returns the level this nested range is started at. Nested range levels are 0 based.

int roctxRangePop()

Stop the current nested range.

Stop the current nested range, and pop it from the stack. If a nested range was active before the last one was started, it becomes again the current nested range.

Returns:

Returns the level the stopped nested range was started at, or a negative value if there was no nested range active.

roctx_range_id_t roctxRangeStartA(const char *message)

Starts a process range.

Start/stop ranges can be started and stopped in different threads. Each timespan is assigned a unique range ID.

Parameters:

message – [in] The message associated with this range.

Returns:

Returns the ID of the new range.

void roctxRangeStop(roctx_range_id_t id)

Stop a process range.

Parameters:

id – [in] roctx_range_id_t returned from roctxRangeStartA to stop