Visible to Intel only — GUID: GUID-5A7179D1-2AD0-4C61-AF79-DE1EACF1BE3E
Visible to Intel only — GUID: GUID-5A7179D1-2AD0-4C61-AF79-DE1EACF1BE3E
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 will be executed.
Output Parameters
- return value (old_status)
-
Specifies the former VM status.
Examples
uint8_t olderr = clear_status (exec_queue);