diff --git a/reference/pgsql/constants.xml b/reference/pgsql/constants.xml index 4bf9e325bdb4..d3dc79b3721e 100644 --- a/reference/pgsql/constants.xml +++ b/reference/pgsql/constants.xml @@ -3,7 +3,7 @@ &reftitle.constants; &extension.constants; - + @@ -211,7 +211,7 @@ Passed to pg_lo_seek. Seek operation is to begin - from the end of the object. + from the end of the object. @@ -234,7 +234,7 @@ - Returned by pg_result_status. Successful completion of a + Returned by pg_result_status. Successful completion of a command returning no data. @@ -246,7 +246,7 @@ - Returned by pg_result_status. Successful completion of a command + Returned by pg_result_status. Successful completion of a command returning data (such as a SELECT or SHOW). @@ -258,7 +258,7 @@ - Returned by pg_result_status. Copy Out (from server) data + Returned by pg_result_status. Copy Out (from server) data transfer started. @@ -270,7 +270,7 @@ - Returned by pg_result_status. Copy In (to server) data + Returned by pg_result_status. Copy In (to server) data transfer started. @@ -282,7 +282,7 @@ - Returned by pg_result_status. The server's response + Returned by pg_result_status. The server's response was not understood. @@ -294,7 +294,7 @@ - Returned by pg_result_status. A nonfatal error + Returned by pg_result_status. A nonfatal error (a notice or warning) occurred. @@ -306,7 +306,7 @@ - Returned by pg_result_status. A fatal error + Returned by pg_result_status. A fatal error occurred. @@ -380,10 +380,10 @@ Passed to pg_result_error_field. - The severity; the field contents are ERROR, - FATAL, or PANIC (in an error message), or - WARNING, NOTICE, DEBUG, - INFO, or LOG (in a notice message), or a localized + The severity; the field contents are ERROR, + FATAL, or PANIC (in an error message), or + WARNING, NOTICE, DEBUG, + INFO, or LOG (in a notice message), or a localized translation of one of these. Always present. @@ -396,9 +396,9 @@ Passed to pg_result_error_field. - The SQLSTATE code for the error. The SQLSTATE code identifies the type of error - that has occurred; it can be used by front-end applications to perform specific - operations (such as error handling) in response to a particular database error. + The SQLSTATE code for the error. The SQLSTATE code identifies the type of error + that has occurred; it can be used by front-end applications to perform specific + operations (such as error handling) in response to a particular database error. This field is not localizable, and is always present. @@ -448,7 +448,7 @@ Passed to pg_result_error_field. - A string containing a decimal integer indicating an error cursor position as an index into the original + A string containing a decimal integer indicating an error cursor position as an index into the original statement string. The first character has index 1, and positions are measured in characters not bytes. @@ -461,10 +461,10 @@ Passed to pg_result_error_field. - This is defined the same as the PG_DIAG_STATEMENT_POSITION field, but - it is used when the cursor position refers to an internally generated - command rather than the one submitted by the client. The - PG_DIAG_INTERNAL_QUERY field will always appear when this + This is defined the same as the PG_DIAG_STATEMENT_POSITION field, but + it is used when the cursor position refers to an internally generated + command rather than the one submitted by the client. The + PG_DIAG_INTERNAL_QUERY field will always appear when this field appears. @@ -477,7 +477,7 @@ Passed to pg_result_error_field. - The text of a failed internally-generated command. This could be, for example, a + The text of a failed internally-generated command. This could be, for example, a SQL query issued by a PL/pgSQL function. @@ -490,9 +490,9 @@ Passed to pg_result_error_field. - An indication of the context in which the error occurred. Presently - this includes a call stack traceback of active procedural language - functions and internally-generated queries. The trace is one entry + An indication of the context in which the error occurred. Presently + this includes a call stack traceback of active procedural language + functions and internally-generated queries. The trace is one entry per line, most recent first. @@ -505,7 +505,7 @@ Passed to pg_result_error_field. - The file name of the PostgreSQL source-code location where the error + The file name of the PostgreSQL source-code location where the error was reported. @@ -518,7 +518,7 @@ Passed to pg_result_error_field. - The line number of the PostgreSQL source-code location where the + The line number of the PostgreSQL source-code location where the error was reported. @@ -599,7 +599,7 @@ Passed to pg_set_error_verbosity. - Specified that returned messages include severity, primary text, + Specified that returned messages include severity, primary text, and position only; this will normally fit on a single line. @@ -612,8 +612,8 @@ Passed to pg_set_error_verbosity. - The default mode produces messages that include the above - plus any detail, hint, or context fields (these may span + The default mode produces messages that include the above + plus any detail, hint, or context fields (these may span multiple lines). @@ -630,6 +630,22 @@ + + + PGSQL_ERRORS_SQLSTATE + (int) + + + + Passed to pg_set_error_verbosity. + Includes only the error severity and the SQLSTATE error code. + If no error code is available, the output is like + PGSQL_ERRORS_TERSE mode. + Before PostgreSQL 11.1, the output is always the same + as in PGSQL_ERRORS_TERSE mode. + + + @@ -869,7 +885,7 @@ The severity; the field contents are ERROR, FATAL, or PANIC (in an error message), or WARNING, NOTICE, DEBUG, INFO, or LOG (in a notice message). This is identical to the PG_DIAG_SEVERITY field except that the contents are never localized. This is present only in versions 9.6 and later / PHP 7.3.0 and later. - + PGSQL_SHOW_CONTEXT_NEVER