Home/ Manual/ pgsql / functions/ pg_copy_to

pg_copy_to

PHP function Edit on GitHub ✎

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

Copy a table to an array

Description

pg_copy_to(PgSql\Connection $connection, string $table_name, string $separator = "\t", string $null_as = "\\\\N"): array|false

pg_copy_to() copies a table to an array. It issues COPY TO SQL command internally to retrieve records.

Parameters

connection: Connection
table_name: Name of the table from which to copy the data into rows.
separator: The token that separates values for each field in each element of rows. Default is \t.
null_as: How SQL NULL values are represented in the rows. Default is \\N ("\\\\N").

Return Values

An array with one element for each line of COPY data, Falseforfailure.

Changelog

Version	Description

Examples

pg_copy_to() example

php

<?php
   $db = pg_connect("dbname=publisher") or die("Could not connect");
   
   $rows = pg_copy_to($db, $table_name);
   
   pg_query($db, "DELETE FROM $table_name");
   
   pg_copy_from($db, $table_name, $rows);
?>