array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.pg-convert.php', 1 => 'pg_convert', 2 => '将关联的数组值转换为适合 SQL 语句的格式', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'PostgreSQL 函数', ), 'prev' => array ( 0 => 'function.pg-consume-input.php', 1 => 'pg_consume_input', ), 'next' => array ( 0 => 'function.pg-copy-from.php', 1 => 'pg_copy_from', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/pgsql/functions/pg-convert.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pg_convert

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

pg_convert — 将关联的数组值转换为适合 SQL 语句的格式

说明

pg_convert(
    PgSql\Connection $connection,
    string $table_name,
    array $values,
    int $flags = 0
): array|false

pg_convert() 检查 values 中的值并将其转换为为适用于 SQL 语句的值。pg_convert() 的前提条件是现有的表 table_name 中具有的列至少有 values 中的单元那么多。table_name 中的字段名以及字段值必须匹配 values 中的索引，并且相应的数据类型必须兼容。成功时返回包含转换后的值的数组，否则返回 false。

注意:

接受 bool 值并转换为 PostgreSQL boolean 值。还支持 bool 值的字符串表示。null 转换为 PostgreSQL NULL。

参数

connection

PgSql\Connection 实例。

table_name

要转换类型的表名。

values

要转换的数据。

flags

PGSQL_CONV_IGNORE_DEFAULT、PGSQL_CONV_FORCE_NULL 或 PGSQL_CONV_IGNORE_NOT_NULL 的任意数量组合。

返回值

转换值后的 array， 或者在失败时返回 false。

错误／异常

当字段的值或类型不能正确匹配 PostgreSQL 的类型时，会抛出 ValueError 或 TypeError。

更新日志

版本 说明
8.3.0 当字段的值或类型不能正确匹配 PostgreSQL 的类型时，现在会抛出 ValueError 或 TypeError 错误；之前触发 E_WARNING。
8.1.0 现在 connection 参数接受 PgSql\Connection 实例，之前接受 resource。

示例

示例 #1 pg_convert() 示例

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

$tmp = array(
'author' => 'Joe Thackery',
'year' => 2005,
'title' => 'My Life, by Joe Thackery'
);

$vals = pg_convert($dbconn, 'authors', $tmp);
?>

参见