Visible to Intel only — GUID: GUID-827C4DA8-5A9A-4DAC-A572-FD01411D2CA9
Visible to Intel only — GUID: GUID-827C4DA8-5A9A-4DAC-A572-FD01411D2CA9
clear_status
Sets the VM Status according to status::success and returns the previous VM Status.
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 |
API
Syntax
namespace oneapi::mkl::vm { uint8_t clear_status (queue& exec_queue ) }
clear_status supports the following devices: CPU and GPU.
Input Parameters
- exec_queue
-
The queue where the routine should be executed.
Output Parameters
- return value (old_status)
-
Specifies the former VM status.
Examples
uint8_t olderr = clear_status (exec_queue);