pg_result_error_field

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

pg_result_error_fieldLiefert den Inhalt eines bestimmtes Feldes zu einer Fehlermeldung

Beschreibung

function pg_result_error_field(PgSql\Result $result, int $field_code): string|false|null

pg_result_error_field() gibt ein Feld der ausführlichen Fehlerbeschreibung zurück, die mit der result-Instanz verbunden ist. Das gewünschte Feld wird im Parameter field_code übergeben.

Da pg_query() und pg_query_params() false zurückgeben, wenn eine Abfrage fehlschlägt, müssen Sie pg_send_query() und pg_get_result() benutzen, um eine Ergebniskennung zu erhalten.

Falls Sie weitergehende Informationen über einen aufgetretenen Fehler bei pg_query() brauchen, können Sie pg_set_error_verbosity() oder pg_last_error() aufrufen und deren Ergebnisse analysieren.

Rückgabewerte

Ein string, der den Inhalt des Fehlerfeldes enthält, oder null, falls das Feld nicht existiert. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.1.0 Der Parameter result erwartet nun eine PgSql\Result-Instanz; vorher wurde eine Ressource erwartet.

Beispiele

Beispiel #1 pg_result_error_field()-Beispiel

<?php
$dbconn
= pg_connect("dbname=publisher") or die("Konnte nicht verbinden.");

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);
?>

Siehe auch