1
0
mirror of https://github.com/php/doc-fr.git synced 2026-04-28 01:03:22 +02:00
Files
archived-doc-fr/reference/pgsql/functions/pg-field-table.xml
T
Jean-Baptiste Nahan 5c660c3e8e Sync with EN
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@344452 c90b9560-bf6c-de11-be94-00142212c4b1
2018-03-05 22:22:47 +00:00

144 lines
3.8 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.pg-field-table" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pg_field_table</refname>
<refpurpose>Retourne le nom ou l'oid d'une table</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>mixed</type><methodname>pg_field_table</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_number</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>oid_only</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<function>pg_field_table</function> retourne le nom de la table à laquelle
le champ appartient ou l'oid de la table si le paramètre
<parameter>oid_only</parameter> vaut &true;.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>result</parameter></term>
<listitem>
<para>
Ressource du résultat d'une requête PostgreSQL, retournée par la fonction
<function>pg_query</function>, <function>pg_query_params</function> ou
<function>pg_execute</function> (et d'autres).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>field_number</parameter></term>
<listitem>
<para>
Numéro du champ, commençant à 0.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>oid_only</parameter></term>
<listitem>
<para>
Par défaut, le nom de la table à laquelle le champ appartient est retourné mais
si le paramètre <parameter>oid_only</parameter> est défini à &true;, alors,
ce sera l'oid qui sera retourné.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
En cas de succès, le nom de la table ou l'oid, &false; en cas d'échec.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Récupération des informations d'une table à partir d'un champ</title>
<programlisting role="php">
<![CDATA[
<?php
$dbconn = pg_connect("dbname=publisher") or die("Connexion impossible");
$res = pg_query($dbconn, "SELECT bar FROM foo");
echo pg_field_table($res, 0);
echo pg_field_table($res, 0, true);
$res = pg_query($dbconn, "SELECT version()");
var_dump(pg_field_table($res, 0));
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
foo
14379580
bool(false)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Retourner l'oid est plus rapide que de retourner le nom de la table, car
la récupération du nom de la table nécessite une requête sur la table système
de la base de données.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>pg_field_name</function></member>
<member><function>pg_field_type</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
-->