Files
doc-fr/reference/ibm_db2/functions/db2-num-fields.xml
Sergey Panteleev 003d65ec02 Sync various docs with EN (#183)
Co-authored-by: George Peter Banyard <girgias@php.net>
2022-03-30 13:09:57 +01:00

121 lines
3.4 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 266f9f6b4bf4bcaa1ef7f23d8eeaaed884b70aaa Maintainer: jsgoupil Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.db2-num-fields" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>db2_num_fields</refname>
<refpurpose>
Retourne le nombre de champs contenu du jeu de résultats
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>int</type><type>false</type></type><methodname>db2_num_fields</methodname>
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
Retourne le nombre de champs contenus dans le jeu de résultats. Cette
fonction est très utile lorsque vous gérez des jeux de résultats retourné
par des requêtes générées dynamiquement ou pour des jeux de résultats
retournés par des procédures d'enregistrement, là où votre application ne
peut faire autrement pour obtenir et utiliser ces résultats.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
Une ressource valide contenant un jeu de résultats.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retourne un entier représentant le nombre de champs dans le jeu de
résultats associé avec la ressource spécifiée. Retourne &false; si la
ressource n'est pas valide.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>db2_num_fields</function></title>
<para>
L'exemple suivant démontre comment obtenir le nombre de champs retournés
dans le jeu de résultats.
</para>
<programlisting role="php">
<![CDATA[
<?php
$sql = "SELECT id, nom, race, poids FROM animaux ORDER BY race";
$stmt = db2_prepare($conn, $sql);
db2_execute($stmt, $sql);
$columns = db2_num_fields($stmt);
echo "Il y a {$columns} colonne dans le jeu de résultats.";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Il y a 4 colonnes dans le jeu de résultats.
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>db2_execute</function></member>
<member><function>db2_field_display_size</function></member>
<member><function>db2_field_name</function></member>
<member><function>db2_field_num</function></member>
<member><function>db2_field_precision</function></member>
<member><function>db2_field_scale</function></member>
<member><function>db2_field_type</function></member>
<member><function>db2_field_width</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
-->