pg_copy_to

pg_copy_to(PgSql\Connection $connection, string $table_name, [string $separator], [string $null_as]): array
```php

`pg_copy_to` copia la tabla `table_name` en un array. Esta función utiliza el comando interno SQL `COPY TO` para insertar los arrays.

## Parámetros

`connection`  
Una instancia `PgSql\Connection`.

`table_name`  
Nombre de la tabla a partir de la cual los datos en `rows` serán copiados.

`separator`  
El marcador que separa los valores para cada campo en cada elemento de `rows`. Por omisión `\t`.

`null_as`  
Cómo las valores `NULL` de SQL son representados en `rows`. Por omisión `\\N` (`"\\\\N"`).

## Valores devueltos

Un `array` con un elemento para cada línea de datos `COPY`, o `false` si ocurre un error.

## 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_copy_to`