PHP-Handbuch: 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:
Ab PHP 5.6.0 werden boolesche Werte akzeptiert, die zu booleschen PostgreSQL Werten konvertiert werden. Zeichenkettendarstellungen von booleschen Werten werden ebenfalls unterstützt. NULL wird in PostgreSQL NULL konvertiert.

Vor PHP 5.6.0 gilt: 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.

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

Changelog

Version	Beschreibung
5.6.0	Nicht länger experimentell. Boolesche/NULL Datentypen werden unterstützt. Unbekannte/nicht unterstützte Datentypen werden ohne Gültigkeitsprüfung maskiert. pg_convert kann mit jedem Datentypen verwendet werden.

Siehe auch

pg_meta_data
pg_insert
pg_select
pg_update
pg_delete