6.4. 错误处理

本节介绍CUDA运行时应用程序编程接口的错误处理功能。

Functions

__host____device__ ​const char* cudaGetErrorName ( cudaError_t error )
Returns the string representation of an error code enum name.
__host____device__ ​const char* cudaGetErrorString ( cudaError_t error )
Returns the description string for an error code.
__host____device__cudaError_t cudaGetLastError ( void )
Returns the last error from a runtime call.
__host____device__cudaError_t cudaPeekAtLastError ( void )
Returns the last error from a runtime call.

Functions

__host____device__ ​const char* cudaGetErrorName ( cudaError_t error )
返回错误代码枚举名称的字符串表示形式。
参数
error
- Error code to convert to string
返回

char* 指向以NULL结尾的字符串的指针

描述

返回一个包含枚举中错误代码名称的字符串。如果错误代码未被识别,则返回"无法识别的错误代码"。

另请参阅:

cudaGetErrorString, cudaGetLastError, cudaPeekAtLastError, cudaError, cuGetErrorName

__host____device__ ​const char* cudaGetErrorString ( cudaError_t error )
返回错误码对应的描述字符串。
参数
error
- Error code to convert to string
返回

char* 指向以NULL结尾的字符串的指针

描述

返回错误码对应的描述字符串。如果错误码未被识别,则返回"unrecognized error code"。

另请参阅:

cudaGetErrorName, cudaGetLastError, cudaPeekAtLastError, cudaError, cuGetErrorString

__host____device__cudaError_t cudaGetLastError ( void )
返回运行时调用的最后一个错误。
描述

返回由同一主机线程中CUDA运行时库实例内任何运行时调用产生的最后一个错误,并将其重置为cudaSuccess

注意:当使用静态链接CUDA运行时的库时,应用程序中可能会出现多个CUDA运行时库实例。

Note:

另请参阅:

cudaPeekAtLastError, cudaGetErrorName, cudaGetErrorString, cudaError

__host____device__cudaError_t cudaPeekAtLastError ( void )
返回运行时调用的最后一个错误。
描述

返回当前主机线程中同一CUDA运行时库实例内任何运行时调用产生的最后一个错误。与cudaGetLastError()不同,此调用不会将错误重置为cudaSuccess

注意:当使用静态链接CUDA运行时的库时,应用程序中可能会出现多个CUDA运行时库实例。

Note:

另请参阅:

cudaGetLastError, cudaGetErrorName, cudaGetErrorString, cudaError