Copia dados da tabela do banco de dados para o array PHP

# Pdo\Pgsql::copyToArray

(PHP 8 >= 8.4.0)

Pdo\Pgsql::copyToArray — Copia dados da tabela do banco de dados para o array PHP

### Descrição

public function Pdo\Pgsql::copyToArray(
string `$tableName`,
string `$separator` = "\t",
string `$nullAs` = "\\\\N",
?string `$fields` = `null`
): array|false

Copia dados de `tableName` para um array usando `separator` como delimitador de campos e lista de campos no parâmetro `fields`.

### Parâmetros

`tableName`
  String contendo o nome da tabela.
`separator`
  Delimitador usado para separar campos em uma entrada do array `rows`.
`nullAs`
  Como interpretar valores SQL `NULL`.
`fields`
  Lista de campos a serem exportados.

### Valor Retornado

Retorna um array de linhas, ou `false` em caso de falha.

### Exemplos

Exemplo #1 Exemplo de Pdo\Pgsql::copyToArray()

Cada elemento retornado é um registro com os campos conectados por `separator` e uma nova linha no final.

    <?php
    $db = new Pdo\Pgsql('pgsql:dbname=test host=localhost', $user, $pass);
    $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    $db->exec('CREATE TABLE fruits (id int, name text, qty int)');
    $db->exec("INSERT INTO fruits VALUES (1, 'apple', 10), (2, 'banana', 20)");

    $rows = $db->copyToArray('fruits');
    var_export($rows);
    ?>

O exemplo acima produzirá:

    array (
      0 => '1	apple	10
    ',
      1 => '2	banana	20
    ',
    )

### Veja Também

- Pdo\Pgsql::copyFromArray() - Copia dados de um array PHP para uma tabela
- Pdo\Pgsql::copyFromFile() - Copia dados do arquivo para a tabela
- Pdo\Pgsql::copyToFile() - Copia dados da tabela para arquivo

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