# pg_convert

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

pg_convert — Convertit des valeurs d'un tableaux associatifs en une forme convenable pour des requêtes SQL

### Description

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

pg_convert() vérifie et convertit le tableau associatif `values` en une requête SQL valide. Pour que pg_convert() fonctionne, il faut que la table `table_name` existe, et contienne au moins autant de colonnes que le tableau `values` a d'éléments. Les noms des champs de `table_name` doivent correspondre aux index du tableau dans `values`. Retourne un tableau avec les valeurs converties en cas de succès, et sinon, `false`.

> Note:

> Les valeurs booléennes sont acceptées et convertie en booléen PostgreSQL. Les représentations de valeurs booléennes sous forme de chaînes de caractères sont également supportées. `null` est converti en NULL PostgreSQL.

### Liste de paramètres

`connection`

  Une instance PgSql\Connection.

`table_name`

  Nom de la table sur pour laquelle les types seront convertis.

`values`

  Données à être converties.

`flags`

  Un nombre de `PGSQL_CONV_IGNORE_DEFAULT`, `PGSQL_CONV_FORCE_NULL` ou `PGSQL_CONV_IGNORE_NOT_NULL`, combiné.

### Valeurs de retour

Un tableau des valeurs converties, ou `false` si une erreur survient.

### Erreurs / Exceptions

Une ValueError ou TypeError est déclenchée lorsque la valeur ou le type du champ ne correspond pas correctement à un type PostgreSQL.

### Historique

Version | Description
--- | ---
8.3.0 | Lance désormais une erreur ValueError ou TypeError lorsque la valeur ou le type du champ ne correspond pas correctement à un type PostgreSQL ; précédemment, un `E_WARNING` était émis.
8.1.0 | Le paramètre `connection` attend désormais une instance de PgSql\Connection ; auparavant, une resource était attendu.

### Exemples

Exemple #1 Exemple avec pg_convert()

`<?php
$dbconn = pg_connect('dbname=foo');
$tmp = array(
'auteur' => 'Joe Thackery',
'annee' => 2005,
'titre' => 'Ma Vie, par Joe Thackery'
);
$vals = pg_convert($dbconn, 'auteurs', $tmp);
?>`

### Voir aussi

- pg_meta_data() - Lit les métadonnées de la table PostgreSQL
- pg_insert() - Insère un tableau dans une table
- pg_select() - Effectue une sélection PostgreSQL
- pg_update() - Modifie les lignes d'une table
- pg_delete() - Efface des lignes PostgreSQL