pg_result_error_field(3) php man page | unix.com

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)