php db2_connect,db2_conn_error - PHP 5 中文文档

(no version information, might be only in CVS)

db2_conn_error–

Returns a string containing the SQLSTATE returned by the last connection attempt

说明

string db2_conn_error

( [resource connection] )

警告

本函数是实验性

的。本函数的行为，包括函数名称以及其它任何关于本函数的文档可能会在没有通知的情况下随

PHP 以后的发布而改变。使用本函数风险自担。

db2_conn_error()

returns an SQLSTATE value representing

the reason the last attempt to connect to a database failed. As

db2_connect()

returns FALSE

in the event of a failed

connection attempt, you do not pass any parameters to

db2_conn_error()

to retrieve the SQLSTATE value.

If, however, the connection was successful but becomes invalid over time,

you can pass the connection

parameter to retrieve

the SQLSTATE value for a specific connection.

To learn what the SQLSTATE value means, you can issue the following command

at a DB2 Command Line Processor prompt:

db2 ‘? sqlstate-value

‘

. You

can also call db2_conn_errormsg()

to retrieve an

explicit error message and the associated SQLCODE value.

参数

connection

A connection resource associated with a connection that initially

succeeded, but which over time became invalid.

返回值

Returns the SQLSTATE value resulting from a failed connection attempt.

Returns an empty string if there is no error associated with the last

connection attempt.

例

例子 1. Retrieving an SQLSTATE value for a failed connection attempt

The following example demonstrates how to return an SQLSTATE value

after deliberately passing invalid parameters to

db2_connect()

.

上例将输出：

SQLSTATE value: 08001

参见

db2_conn_errormsg()

db2_connect()

db2_stmt_error()

db2_stmt_errormsg()