pg_last_oid
(PHP 4 >= 4.2.0, PHP 5)
pg_last_oid — Retourne l'identifiant de la derni�re ligne
Description
pg_last_oid() sert � r�cup�rer le OID assign� � une ligne ins�r�e.
Le champ OID est devenu optionnel depuis PostgreSQL 7.2 et ne sera plus pr�sent par d�faut dans PostgreSQL 8.1. Lorsque le champ OID n'est pas pr�sent dans la table, le programmeur doit utiliser pg_result_status() pour v�rifier si la ligne a �t� correctement ins�r�e.
Pour obtenir la valeur d'un champ SERIAL dans une ligne ins�r�e, il est n�cessaire d'utiliser la fonction CURRVAL de PostgreSQL en nommant la s�quence � qui la derni�re valeur est requise. Si le nom de la s�quence est inconnu, la fonction PostgreSQL 8.0 pg_get_serial_sequence est n�cessaire.
PostgreSQL 8.1 a une fonction LASTVAL qui retourne la valeur de la s�quence la plus r�cemment utilis�e de la session. Ceci permet d'�viter de nommer la s�quence, la table ou la colonne.
Note: Auparavant, cette fonction s'appelait pg_getlastoid().
Liste de param�tres
- result
-
Ressource de r�sultat de requ�te PostgreSQL, retourn�e par pg_query(), pg_query_params() ou pg_execute() (entre autres).
Valeurs de retour
Une cha�ne de caract�res contenant le OID assign� � la plus r�cente ligne ins�r�e dans la connexion connection sp�cifi�e ou FALSE en cas d'erreur ou de OID indisponible.
Exemples
Exemple #1 Exemple avec pg_last_oid()
<?php
$pgsql_conn = pg_connect("dbname=mark host=localhost");
$res1 = pg_query("CREATE TABLE test (a INTEGER) WITH OIDS");
$res2 = pg_query("INSERT INTO test VALUES (1)");
$oid = pg_last_oid($res2);
?>
Voir aussi
- pg_query() - Ex�cute une requ�te PostgreSQL
- pg_result_status() - Lit le statut du r�sultat