Files
doc-fr/reference/pgsql/functions/pg-last-oid.xml
Yannick Torres 0720f7cf84 sync with EN
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@254064 c90b9560-bf6c-de11-be94-00142212c4b1
2008-03-02 10:41:12 +00:00

131 lines
3.6 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.15 $ -->
<!-- EN-Revision: 1.13 Maintainer: jsgoupil Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.pg-last-oid" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pg_last_oid</refname>
<refpurpose>
Retourne l'identifiant de la dernière ligne
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>pg_last_oid</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_last_oid</function> sert à récupérer le <varname>OID</varname>
assigné à une ligne insérée.
</para>
<para>
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
<function>pg_result_status</function> pour vérifier si la ligne
a été correctement insérée.
</para>
<para>
Pour obtenir la valeur d'un champ <literal>SERIAL</literal> dans une ligne
insérée, il est nécessaire d'utiliser la fonction
<literal>CURRVAL</literal> 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 <literal>pg_get_serial_sequence</literal> est
nécessaire.
</para>
<para>
PostgreSQL 8.1 a une fonction <literal>LASTVAL</literal> 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.
</para>
<note>
<para>
Auparavant, cette fonction s'appelait <function>pg_getlastoid</function>.
</para>
</note>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>result</parameter></term>
<listitem>
<para>
Ressource de résultat de requête PostgreSQL, retournée par
<function>pg_query</function>, <function>pg_query_params</function> ou
<function>pg_execute</function> (entre autres).
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Une &string; contenant le OID assigné à la plus récente ligne insérée dans
la connexion <parameter>connection</parameter> spécifiée ou &false; en cas
d'erreur ou de OID indisponible.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>pg_last_oid</function></title>
<programlisting role="php">
<![CDATA[
<?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);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>pg_query</function></member>
<member><function>pg_result_status</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->