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.

Note:

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

Example #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