Konvertiert die Werte eines assoziativen Arrays in die für SQL-Anweisungen passende Form

# pg_convert

(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

### Beschreibung

function pg_convert(
PgSql\Connection `$connection`,
string `$table_name`,
array `$values`,
int `$flags` = 0
): array|false

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.

### Parameter-Liste

`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`.

### Rückgabewerte

Ein Array mit den konvertierten Werten. Bei einem Fehler wird `false` zurückgegeben.

### Fehler/Exceptions

Wenn der Wert oder der Typ eines Feldes nicht mit einem PostgreSQL-Typ übereinstimmt, wird ein ValueError oder TypeError geworfen.

### Changelog

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.

### Beispiele

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

### Siehe auch

- pg_meta_data() - Liefert die Metadaten einer Tabelle als Array
- pg_insert() - Überträgt Werte aus einem Array in eine Tabelle
- pg_select() - Wählt Datensätze aus
- pg_update() - Aktualisiert eine Tabelle
- pg_delete() - Löscht Datensätze

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open