pg_connection_status
pg_copy_from
PostgreSQL-Funktionen
PHP Manual

# pg_convert

(PHP 4 >= 4.3.0, PHP 5)

pg_convert — Konvertiert die Werte eines assoziativen Arrays in passende Werte für SQL-Kommandos.

### Beschreibung

array pg_convert ( resource `$connection` , string `$table_name` , array `$assoc_array` [, int `$options` = 0 ] )

pg_convert() prüft und konvertiert die Werte in `assoc_array` 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 `assoc_array` Elemente. Die Feldnamen in `table_name` müssen mit den Schlüsseln von `assoc_array` ü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: Falls die Tabelle `table_name` boolesche Felder enthält, dürfen Sie die Konstante `TRUE` nicht als Wert im Array `assoc_array` verwenden. Sie wird zu dem String 'TRUE' konvertiert, der kein gültiger Wert für boolesche Felder in PostgreSQL ist. Benutzen Sie stattdessen t, true, 1, y oder yes.

Warnung

Diese Funktion ist EXPERIMENTELL. Das Verhalten, der Funktionsname und alles Andere, was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf eigenes Risiko.

### Parameter-Liste

`connection`

  PostgreSQL Verbindungskennung.

`table_name`

  Name der Tabelle, für die die Arrayelemente konvertiert werden.

`assoc_array`

  Die Daten, die konvertiert werden.

`options`

  Beliebige Kombination der Konstanten `PGSQL_CONV_IGNORE_DEFAULT`, `PGSQL_CONV_FORCE_NULL` oder `PGSQL_CONV_IGNORE_NOT_NULL`.

### Rückgabewerte

Ein array mit den konvertierten Werten oder `FALSE`, falls ein Fehler auftrat.

### 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() - Gibt Metadaten einer Tabelle als Array zurück

pg_connection_status
pg_copy_from
PostgreSQL-Funktionen
PHP Manual