clear_status

Sets the VM Status according to status::success and returns the previous VM Status.

Syntax

uint8_t clear_status(queue &exec_queue)

Description

The clear_status function sets the VM status to status::success and returns the previous VM status.

The global VM Status is a single value and it accumulates all errors that happen inside VM functions. The following table lists the possible error values.

Status	Description
Successful Execution
status::success	VM function execution completed successfully
status::not_defined	VM status not defined
Warnings
status::accuracy_warning	VM function execution completed successfully in a different accuracy mode
Computational Errors
status::errdom	Values are out of a range of definition producing invalid (QNaN) result
status::sing	Values cause divide-by-zero (singularity) errors and produce and invalid (QNaN or Inf) result
status::overflow	An overflow happened during the calculation process
status::underflow	An underflow happened during the calculation process

Input Parameters

exec_queue

The queue where the routine should be executed.

Output Parameters

return value (old_status)

Specifies the former VM status.

Example

uint8_t olderr = clear_status (exec_queue);

Parent topic: VM Service Functions