(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_convert — Converte valores de array associativo em formas adequadas para instruções SQL
$connection
,$table_name
,$values
,$flags
= 0
pg_convert() verifica e converte os valores em
values
em valores adequados para uso em uma instrução
SQL. A pré-condição para pg_convert() é a
existência de uma tabela table_name
que tenha pelo menos
tantas colunas quanto values
tem elementos. Os
nomes dos campos em table_name
devem corresponder aos
índices em values
e os tipos de dados correspondentes devem ser
compatíveis. Retorna um array com os valores convertidos em caso de sucesso, false
caso contrário.
Nota:
Os valores booleanos são aceitos e convertidos em booleanos do PostgreSQL. Representações de string de valores booleanos também são suportadas.
null
é convertido para PostgreSQL NULL.
connection
Uma instância de PgSql\Connection.
table_name
Nome da tabela na qual converter tipos.
values
Dados a serem convertidos.
flags
Qualquer número de PGSQL_CONV_IGNORE_DEFAULT
,
PGSQL_CONV_FORCE_NULL
ou
PGSQL_CONV_IGNORE_NOT_NULL
, combinado.
Um ValueError ou TypeError é lançado quando o valor ou tipo de campo não corresponde corretamente ao tipo do PostgreSQL.
Versão | Descrição |
---|---|
8.3.0 |
Agora lança um erro ValueError ou TypeError
quando o valor ou tipo de campo não corresponde corretamente ao tipo do PostgreSQL;
anteriormente um E_WARNING era emitido.
|
8.1.0 |
O parâmetro connection agora espera uma instância de PgSql\Connection;
anteriormente, um resource era esperado.
|
Exemplo #1 Exemplo de 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);
?>