array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.pg-convert.php', 1 => 'pg_convert', 2 => 'Converte valores de array associativo em formas adequadas para instruções SQL', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Funções 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' => 'pt_BR', '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 — Converte valores de array associativo em formas adequadas para instruções SQL

Descrição

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

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.

Parâmetros

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.

Valor Retornado

Um array de valores convertidos, ou false em caso de falha.

Erros/Exceções

Um ValueError ou TypeError é lançado quando o valor ou tipo de campo não corresponde corretamente ao tipo do PostgreSQL.

Registro de Alterações

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.

Exemplos

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);
?>

Veja Também