pg_convert

(PHP 4 >= 4.3.0, PHP 5)

pg_convert — Conviertir valores de un array asociativo en valores adcuados para sentencias SQL

Descripción

array pg_convert ( resource $connection , string $table_name , array $assoc_array [, int $options = 0 ] )

pg_convert() evalua y convierte los valores de un assoc_array en valores adecuados para su uso en una sentencia SQL. La condición previa para la función pg_convert() es la existencia de una tabla con nombre igual al parametro table_name que tiene por lo menos tantas columnas como elementos tiene el assoc_array. Los nombres de campos en table_name deben coincidir con los índices de assoc_array y los tipos de datos correspondientes deben ser compatibles. Devuelve un array con los valores convertidos en caso de éxito, FALSE de lo contrario.

Nota:

Desde PHP 5.6.0, acepta valores booleanos. Se convierten a booleanos de PostgreSQL. También se admiten representaciones de string de valores booleanos. NULL se convierte al NULL de PostgreSQL.

Antes de PHP 5.6.0, si existen campos booleanos en table_name, no use la constante TRUE en assoc_array. Será convertida al string 'TRUE', el cual no es una entrada válida para campos booleanos en PostgreSQL. Use t, true, 1, y, yes en su lugar.

Parámetros

connection

Recurso de conexión de base de datos PostgreSQL.

table_name

Nombre de la tabla contra la que convertir los tipos.

assoc_array

Los datos que desea convertir.

options

Cualquier número de PGSQL_CONV_IGNORE_DEFAULT, PGSQL_CONV_FORCE_NULL ó PGSQL_CONV_IGNORE_NOT_NULL, ó una combinación de estos.

Valores devueltos

Un array de valores convertidos, o FALSE en caso de error.

Ejemplos

Ejemplo #1 Ejemplo 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);
?>

Historial de cambios

Versión Descripción
5.6.0 Ya no es experimental. Se admiten los tipos de datos boolean/NULL. Los tipos de datos desconocidos/no soportados son escapados sin validación. Se podría emplear pg_convert() con cualquier tipo de dato.

Ver también