pg_convert
連想配列の値を、SQL 文として実行可能な形式に変換する
&reftitle.description;
arrayfalsepg_convert
PgSql\Connectionconnection
stringtable_name
arrayvalues
intflags0
pg_convert は、values
の中の値をチェックし、SQL 文の中で使用可能な形式に変換します。
少なくとも values の要素数以上のカラムを持つ
テーブル table_name が存在することが前提条件と
なります。values の要素名が
table_name のフィールド名と一致し、また
要素に対応する値はフィールドのデータ型と互換性がなければなりません。
成功した場合に変換後の値の配列、それ以外の場合に &false; を返します。
この関数は、boolean 値も受付けることができ、
PostgreSQL の boolean 型に変換します。
boolean 値の文字列表現にも対応しています。
&null; は、PostgreSQL の NULL に変換します。
&warn.experimental.func;
&reftitle.parameters;
connection
&pgsql.parameter.connection;
table_name
変換対象となるテーブルの名前。
values
変換されるデータ。
flags
PGSQL_CONV_IGNORE_DEFAULT,
PGSQL_CONV_FORCE_NULL あるいは
PGSQL_CONV_IGNORE_NOT_NULL の組み合わせ。
&reftitle.returnvalues;
変換された値の配列を返します。
&return.falseforfailure;
&reftitle.errors;
フィールドの値や型が PostgreSQL の型と一致しない場合、
ValueError または TypeError
がスローされます。
&reftitle.changelog;
&Version;
&Description;
8.3.0
フィールドの値や型が PostgreSQL の型と一致しない場合、
ValueError または TypeError
がスローされるようになりました。
これより前のバージョンでは、
E_WARNING が発生していました。
&pgsql.changelog.connection-object;
&reftitle.examples;
pg_convert の例
'Joe Thackery',
'year' => 2005,
'title' => 'My Life, by Joe Thackery'
);
$vals = pg_convert($dbconn, 'authors', $tmp);
?>
]]>
&reftitle.seealso;
pg_meta_data
pg_insert
pg_select
pg_update
pg_delete