PHP Manual
PrevNext

PDO::errorCode

(no version information, might be only in CVS)

PDO::errorCode --  Fetch the SQLSTATE associated with the last operation on the database handle

Description

int PDO::errorCode ( void )

Warning

This function is EXPERIMENTAL. The behaviour of this function, the name of this function, and anything else documented about this function may change without notice in a future release of PHP. Use this function at your own risk.

Return Values

Returns a SQLSTATE, a five-character alphanumeric identifier defined in the ANSI SQL standard.

PDO::errorCode() only retrieves error codes for operations performed directly on the database handle. If you create a PDOStatement object through PDO::prepare() or PDO::query() and invoke an error on the statement handle, PDO::errorCode() will return PDO_ERR_NONE. You must call PDOStatement::errorCode() to return the error code for an operation performed on a particular statement handle.

Examples

Example 1. Retrieving a SQLSTATE code

<?php
/* Provoke an error -- the BONES table does not exist */
$dbh->exec("INSERT INTO bones(skull) VALUES ('lucy')");

echo "\nPDO::errorCode(): ";
print $dbh->errorCode();
?>

The above example will output:

PDO::errorCode(): 42S02

See Also

PDO::errorInfo()
PDOStatement::errorCode()
PDOStatement::errorInfo()

PrevHomeNext
PDO::__constructUpPDO::errorInfo