pg_result_error_field
pg_result_error_field returns one of the detailed error message fields associated with result instance. It is only available against a PostgreSQL 7.4 or above server. The error field is specified by the field_code.
Because pg_query and pg_query_params return false if the query fails, you must use pg_send_query and pg_get_result to get the result handle.
If you need to get additional error information from failed pg_query queries, use pg_set_error_verbosity and pg_last_error and then parse the result.
Parameters
- result
-
An PgSql\Result instance, returned by pg_query, pg_query_params or pg_execute(among others).
- field_code
-
Possible field_code 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_INTERNAL_QUERY (PostgreSQL 8.0+ only), PGSQL_DIAG_CONTEXT, PGSQL_DIAG_SOURCE_FILE, PGSQL_DIAG_SOURCE_LINE or PGSQL_DIAG_SOURCE_FUNCTION.
Return Values
A string containing the contents of the error field, null if the field does not exist or false on failure.
Changelog
Version | Description |
8.1.0 | The result parameter expects an PgSql\Result instance now; previously, a resource was expected. |