PG_RESULT_ERROR_FIELD(3) PG_RESULT_ERROR_FIELD(3)
pg_result_error_field - Returns an individual field of an error report.
SYNOPSIS
string pg_result_error_field (resource $result, int $fieldcode)
DESCRIPTION
pg_result_error_field(3) returns one of the detailed error message fields associated with $result resource. It is only available against a
PostgreSQL 7.4 or above server. The error field is specified by the $fieldcode.
Because pg_query(3) and pg_query_params(3) return FALSE if the query fails, you must use pg_send_query(3) and pg_get_result(3) to get the
result handle.
If you need to get additional error information from failed pg_query(3) queries, use pg_set_error_verbosity(3) and pg_last_error(3) and
then parse the result.
PARAMETERS
o $result
- A PostgreSQL query result resource from a previously executed statement.
o $fieldcode
- Possible $fieldcode values are: PGSQL_DIAG_SEVERITY, PGSQL_DIAG_SQLSTATE, PGSQL_DIAG_MESSAGE_PRIMARY, PGSQL_DIAG_MESSAGE_DETAIL,
PGSQL_DIAG_MESSAGE_HINT, PGSQL_DIAG_STATEMENT_POSITION, PGSQL_DIAG_INTERNAL_POSITION (PostgreSQL 8.0+ only), PGSQL_DIAG_INTER-
NAL_QUERY (PostgreSQL 8.0+ only), PGSQL_DIAG_CONTEXT, PGSQL_DIAG_SOURCE_FILE, PGSQL_DIAG_SOURCE_LINE or PGSQL_DIAG_SOURCE_FUNC-
TION.
RETURN VALUES
A string containing the contents of the error field, NULL if the field does not exist or FALSE on failure.
EXAMPLES
Example #1
pg_result_error_field(3) example
<?php
$dbconn = pg_connect("dbname=publisher") or die("Could not connect");
if (!pg_connection_busy($dbconn)) {
pg_send_query($dbconn, "select * from doesnotexist;");
}
$res1 = pg_get_result($dbconn);
echo pg_result_error_field($res1, PGSQL_DIAG_SQLSTATE);
?>
SEE ALSO
pg_result_error(3).
PHP Documentation Group PG_RESULT_ERROR_FIELD(3)
