PQresultStatus
功能描述
返回命令的结果状态。
接口原型
ExecStatusType PQresultStatus(const PGresult *res);
参数说明
参数名 | 参数说明 |
---|---|
res | 执行命令后获取的结果指针。 |
返回值
返回命令结果的状态,可能返回下面结果之一:
返回结果值 | 说明 |
---|---|
PGRES_EMPTY_QUERY | 发送给服务器的字串是空的。 |
PGRES_COMMAND_OK | 成功完成一个不返回数据的命令。 |
PGRES_TUPLES_OK | 成功执行一个返回数据的查询(比如SELECT或者SHOW)。 |
PGRES_COPY_OUT | (从服务器)Copy Out (拷贝出)数据传输开始。 |
PGRES_COPY_IN | Copy In(拷贝入)(到服务器)数据传输开始。 |
PGRES_BAD_RESPONSE | 服务器的响应无法理解。 |
PGRES_NONFATAL_ERROR | 发生了一个非致命错误(通知或者警告)。 |
PGRES_FATAL_ERROR | 发生了一个致命错误。 |
PGRES_COPY_BOTH | 拷贝入/出(到和从服务器)数据传输开始。这个特性当前只用于流复制, 所以这个状态不会在普通应用中发生。 |
PGRES_SINGLE_TUPLE | PGresult包含一个来自当前命令的结果元组。 这个状态只在查询选择了单行模式时发生。 |
其他
状态为PGRES_NONFATAL_ERROR的结果永远不会直接由PQexec 或者其它查询执行函数返回;这类的结果会被传递给通知处理器。