Files
doc-fr/reference/pgsql/functions/pg-last-oid.xml
T
Yannick Torres 9b7f788369 Convert to UTF-8
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@297607 c90b9560-bf6c-de11-be94-00142212c4b1
2010-04-07 06:31:19 +00:00

131 lines
3.7 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 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:"~/.phpdoc/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
-->