Converte valores de array associativo em formas adequadas para instruções SQL

# 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

function 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

- pg_meta_data() - Obtém metadados para tabela
- pg_insert() - Insere array na tabela
- pg_select() - Seleciona registros
- pg_update() - Atualiza tabela
- pg_delete() - Exclui registros

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open