pg_put_line

(PHP 4 >= 4.0.3, PHP 5)

pg_put_line -- Envoie une chaîne au serveur PostgreSQL

Description

bool pg_put_line ( string data )

bool pg_put_line ( resource connection, string data )

pg_put_line() envoie une chaîne (terminée par NULL) au serveur PostgreSQL. Ceci est pratique pour effectuer des insertions très rapides dans une table, initiée par une opération de copie PostgreSQL copy-operation. Le caractère final NULL est automatiquement ajouté. Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Note : Notez que l'application doit explicitement ajouter les deux caractères "\." à la fin de la chaîne pour indiquer au serveur qu'elle a finit d'envoyer des données.

Exemple 1. Exemple avec pg_put_line()

<?php
$conn
= pg_pconnect("dbname=foo");
pg_query($conn, "create table bar (a int4, b char(16), d float8)");
pg_query($conn, "copy bar from stdin");
pg_put_line($conn, "3\tBonjour le monde\t4.5\n");
pg_put_line($conn, "4\tAu revoir le monde\t7.11\n");
pg_put_line($conn, "\\.\n");
pg_end_copy($conn);
?>

Avertissement

L'utilisation de pg_put_line() produit des opérations sur de très larges objets, ce qui peut conduire pg_lo_read() et pg_lo_tell() à échouer en suivant. Vous pouvez utiliser les fonctions pg_copy_from() et pg_copy_to() à la place.

Voir aussi pg_end_copy().