[edit] Last updated: Fri, 23 Mar 2012

pg_convert

(PHP 4 >= 4.3.0, PHP 5)

pg_convert — Konwertuje tablice asocjacyjne na postać użyteczną w zapytaniu SQL.

Opis

array pg_convert ( resource $połączenie , string $nazwa_tabeli , array $tablica_asocjacyjna [, int $opcje ] )

pg_convert() sprawdza i konwertuje wartości w tablica_asocjacyjna na postać użyteczną dla zapytania SQL. Warunkiem koniecznym dla pg_convert() jest istnienie tabeli nazwa_tabeli, ktora ma przynajmniej tyle kolumn, ile tablica_asocjacyjna ma elementów. Nazwy pól w nazwa_tabeli muszą pasować do indeksów w parametrze tablica_asocjacyjna i odpowiednie typy danych muszą być zgodne. Zwraca tabelę z przekonwertowanymi wartościami w razie sukcesu, FALSE w przeciwnym wypadku.

Informacja:
Jeśli istnieją pola typu boolean w nazwa_tabeli, nie używaj stałej wartości TRUE w parametrze tablica_asocjacyjna. Zostanie on przekonwertowany do łańcucha 'TRUE', który nie jest poprawnym wpisem dla pól typu boolean w PostgreSQL. W zamian użyj jednej z propozycji: t, true, 1, y, yes.

Ostrzeżenie

Ta funkcja jest w stadium EKSPERYMENTALNYM. Oznacza to, że zachowanie funkcji, jej nazwa, w zasadzie wszystko udokumentowane tutaj może zostać zmienione w przyszłych wersjach PHP bez wcześniejszego uprzedzenia. Używaj tej funkcji na własne ryzyko.

Parametry

połączenie: Źródło połączenia do bazy PostgreSQL.
nazwa_tabeli: Nazwa tabeli, w stosunku do której będą konwertowane typy.
tablica_asocjacyjna: Dane do konwersji.
options: Kombinacja dowolnej ilości poniższych stałych: PGSQL_CONV_IGNORE_DEFAULT, PGSQL_CONV_FORCE_NULL lub PGSQL_CONV_IGNORE_NOT_NULL.

Zwracane wartości

Typ tablicowy (ang. array) z przekonwertowanymi wartościami, lub FALSE w razie błędu.

Przykłady

Przykład #1 pg_convert() - przykład


<?php
  $polaczenie = pg_connect('dbname=foo');

  $tmp = array(
      'autor' => 'Jan Hakreski',
      'rok' => 2005,
      'tytuł' => 'Życie Jana Hakerskiego'
  );

  $wartosci = pg_convert($polaczenie, 'autorzy', $tmp);
?>

Zobacz też:

pg_meta_data() - Pobiera informacje o tabeli

pg_copy_from

pg_connection_status

[edit] Last updated: Fri, 23 Mar 2012

add a note User Contributed Notes pg_convert

Andrew Falanga 24-Feb-2005 12:03


Why does this function, pg_convert(), reject the string 'TRUE' as a valid value for the boolean types?  I'm using PHP 4.3.9 and my web page originally set the value for submission to update, to 'TRUE'.  pg_convert() threw it back to me saying that it's not a valid value for boolean types.  However, the postgresql website says otherwise.  See http://www.postgresql.org/docs/7.4/static/datatype-boolean.html for the context of my question/comment.

31-Mar-2004 08:02


The only options that I see are:



PGSQL_CONV_IGNORE_DEFAULT  - Do not use DEAFULT value by removing field from returned array

PGSQL_CONV_FORCE_NULL - Convert to NULL if string is null string

PGSQL_CONV_IGNORE_NOT_NULL  - Ignore NOT NULL constraints



These are constants, so don't quote them or anything.

dharana at dharana dot net 12-May-2003 06:28


I've found "options" possible values:



PG_CONV_CHECK - check only

PG_CONV_STRICT - raise warning for non fatal error

PG_CONV_QUOTE - add quote around values for vchar, text datetime.

PG_CONV_SLASH - add slashes if it needed.

PG_CONV_NULLCHK - check values are defined for NOT NULL fields.

PG_CONV_NO_DEFAULT - ignore default value even if value is empty string.

add a note