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 ([ resource $connection ], string $data )

pg_put_line() envoie une cha�ne (termin�e par NULL) au serveur PostgreSQL. Ceci est n�cessaire en conjonction avec une commande COPY FROM PostgreSQL.

COPY est un chargement tr�s rapide des donn�es support� par PostgreSQL. Les donn�es sont pass�es sans �tre analys�es et dans une simple transaction.

Une alternative plut�t que d'utiliser la commande brute pg_put_line() est d'utiliser pg_copy_from(). C'est une interface bien plus simple.

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, avant d'appeler pg_end_copy().

Avertissement

L'utilisation de pg_put_line() cause sur la plupart des objets de grande taille � �chouer, incluant pg_lo_read() et pg_lo_tell(). Vous pouvez utiliser pg_copy_from() et pg_copy_to() � la place.

Liste de param�tres

connection

La ressource de connexion de la base de donn�es PostgreSQL. Lorsque connection n'est pas pr�sent, la connexion par d�faut est utilis�e. La connexion par d�faut est la derni�re connexion faite par pg_connect() ou pg_pconnect().

data

Une ligne de texte � envoyer directement au serveur PostgreSQL. Un caract�re d'arr�t NULL est automatiquement ajout�.

Valeurs de retour

Cette fonction retourne TRUE en cas de succ�s, FALSE en cas d'�chec.

Exemples

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\tAurevoir le monde\t7.11\n");
  
pg_put_line($conn"\\.\n");
  
pg_end_copy($conn);
?>

Voir aussi