A newer version of this document is available. Customers should click here to go to the newest version.
get_status
Gets the VM Status.
Description
The get_status function gets the VM status.
The global VM Status is a single value and it accumulates via bitwise OR ( | ) all computational 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
uint8_t get_status (queue& exec_queue )
get_status supports the following devices: CPU and GPU.
Input Parameters
- exec_queue
 -  
     
The queue where the routine should be executed.
 
Output Parameters
- return value (status)
 -  
     
Specifies the VM status.
 
Examples
uint8_t err = get_status (exec_queue);
if (err & status::errdom)
{
    std::cout << ”Errdom status returned” << std::endl;
}
if (err & status::sing)
{
    std::cout << ”Singularity status returned” << std::endl;
}