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:

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