pg_delete

pg_delete(PgSql\Connection $connection, string $table_name, array $conditions, [int $flags]): string
```php

`pg_delete` elimina las filas de una tabla especificadas por las claves y valores del array asociativo `conditions`.

Si `flags` es proporcionado, `pg_convert` es aplicado a `conditions` con los flags proporcionados.

Por omisión `pg_delete` pasa valores sin tratar. Los valores deben ser escapados o el flag `PGSQL_DML_ESCAPE` debe ser especificado en `flags`. `PGSQL_DML_ESCAPE` añade comillas y escapa los parámetros/identificadores. Por lo tanto, los nombres de tablas/columnas se vuelven sensibles a mayúsculas/minúsculas.

Tenga en cuenta que ni el escape ni las consultas preparadas pueden proteger consultas LIKE, JSON, arrays, Regex, etc. Estos parámetros deben ser tratados según su contexto. Es decir, escapar/validar los valores.

## Parámetros

`connection`  
Una instancia `PgSql\Connection`.

`table_name`  
Nombre de la tabla desde la cual las filas serán eliminadas.

`conditions`  
Un `array` donde las claves son los nombres de los campos de la tabla `table_name` y donde los valores son los valores de estos campos que deben ser eliminados.

`flags`  
Cualquier combinación de los siguientes valores: `PGSQL_CONV_FORCE_NULL`, `PGSQL_DML_NO_CONV`, `PGSQL_DML_ESCAPE`, `PGSQL_DML_EXEC`, `PGSQL_DML_ASYNC` o `PGSQL_DML_STRING`. Si `PGSQL_DML_STRING` forma parte del parámetro `flags` entonces, la consulta será devuelta. Cuando la constante `PGSQL_DML_NO_CONV` o la constante `PGSQL_DML_ESCAPE` están definidas, ninguna llamada a la función `pg_convert` será realizada internamente.

## Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error. Devuelve un `string` si `PGSQL_DML_STRING` es pasado en el parámetro `flags`.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | El parámetro `connection` ahora espera una instancia de `PgSql\Connection` ; anteriormente, se esperaba un `resource`. |

## Ejemplos

Ejemplo con `pg_delete`