(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_convert — Konvertiert die Werte eines assoziativen Arrays in die für SQL-Anweisungen passende Form
$connection
,$table_name
,$values
,$flags
= 0
pg_convert() prüft und konvertiert die Werte in
values
in passende Werte für ein SQL-Kommando.
Voraussetzung für pg_convert() ist die Existenz einer
Tabelle table_name
, die mindestens so viele Spalten
hat, wie values
Elemente. Die Feldnamen in
table_name
müssen mit den Schlüsseln von
values
übereinstimmen und die entsprechenden
Datentypen müssen kompatibel sein. Zurückgegeben wird bei Erfolg ein Array
mit den konvertierten Werten oder false
, falls ein Fehler auftrat.
Hinweis:
Boolesche Werte werden akzeptiert und zu booleschen PostgreSQL-Werten konvertiert. Zeichenkettendarstellungen von booleschen Werten werden ebenfalls unterstützt.
null
wird in PostgreSQL-NULL konvertiert.
connection
Eine PgSql\Connection-Instanz.
table_name
Der Name der Tabelle, für die die Arrayelemente konvertiert werden.
values
Die Daten, die konvertiert werden.
flags
Eie beliebige Kombination der Konstanten
PGSQL_CONV_IGNORE_DEFAULT
,
PGSQL_CONV_FORCE_NULL
und
PGSQL_CONV_IGNORE_NOT_NULL
.
Wenn der Wert oder der Typ eines Feldes nicht mit einem PostgreSQL-Typ übereinstimmt, wird ein ValueError oder TypeError geworfen.
Version | Beschreibung |
---|---|
8.3.0 |
Wenn der Wert oder Typ eines Feldes nicht mit einem PostgreSQL-Typ
übereinstimmt, wird nun ein ValueError oder
TypeError geworfen; zuvor wurde ein
E_WARNING ausgegeben.
|
8.1.0 |
Der Parameter connection erwartet nun eine PgSql\Connection-Instanz;
vorher wurde eine Ressource erwartet.
|
Beispiel #1 pg_convert()-Beispiel
<?php
$dbconn = pg_connect('dbname=foo');
$tmp = array(
'author' => 'Joe Thackery',
'year' => 2005,
'title' => 'My Life, von Joe Thackery'
);
$vals = pg_convert($dbconn, 'authors', $tmp);
?>