-
Notifications
You must be signed in to change notification settings - Fork 157
/
Copy pathdb2-fetch-array.xml
172 lines (162 loc) · 5.18 KB
/
db2-fetch-array.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 871b71764cdca8238069f27436d96011a6a2cb36 Maintainer: jsgoupil Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.db2-fetch-array" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>db2_fetch_array</refname>
<refpurpose>
Retourne un tableau, indexé par la position des colonnes, représentant une
ligne du jeu de résultats
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>array</type><type>false</type></type><methodname>db2_fetch_array</methodname>
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>row_number</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
Retourne un tableau, indexé par la position des colonnes, représentant une
ligne du jeu de résultats. Les indices du tableau sont numériques et
commencent par zéro.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
Une ressource <literal>stmt</literal> valide contenant le jeu de
résultats.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>row_number</parameter></term>
<listitem>
<para>
Demande une ligne spécifique indexée numériquement qui commence par la
valeur 1 au jeu de résultat. En fournissant ce paramètre, vous
obtiendrez une alerte PHP si le jeu de résultat
utilise une curseur d'avancement seul.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retourne un tableau à indices numériques commençant à 0 indexé avec la position des
colonnes. Cet indice pointe vers des données de la ligne suivante
ou la ligne demandée dans le jeu de résultats. Retourne &false;
s'il n'y a pas de ligne disponible dans le jeu de résultats ou si
la ligne demandée par <parameter>row_number</parameter> n'existe
pas dans le jeu de résultats.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Itère avec un curseur d'avancement seul</title>
<para>
Si vous appelez <function>db2_fetch_array</function> sans le numéro d'une
ligne spécifique, la ligne suivante sera automatiquement récupérée 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);
$result = db2_execute($stmt);
while ($row = db2_fetch_array($stmt)) {
printf ("%-5d %-16s %-32s %10s\n",
$row[0], $row[1], $row[2], $row[3]);
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
0 Pook chat 3.20
5 Rickety Ride chèvre 9.70
2 Smarty cheval 350.00
]]>
</screen>
</example>
<example>
<title>Récupération de lignes spécifiques avec <function>db2_fetch_array</function>
provenant d'un curseur flottant</title>
<para>
Si votre jeu de résultats utilise un curseur flottant, vous pouvez
appeler la fonction <function>db2_fetch_array</function> avec une numéro
de ligne spécifique. L'exemple suivant récupère chaque ligne paire dans
le jeu de résultats, commençant avec la deuxième ligne.
</para>
<programlisting role="php">
<![CDATA[
<?php
$sql = "SELECT id, nom, race, poids FROM animaux ORDER BY race";
$result = db2_exec($stmt, $sql, array('cursor' => DB2_SCROLLABLE));
$i=2;
while ($row = db2_fetch_array($result, $i)) {
printf ("%-5d %-16s %-32s %10s\n",
$row[0], $row[1], $row[2], $row[3]);
$i = $i + 2;
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
0 Pook chat 3.20
5 Rickety Ride chèvre 9.70
2 Smarty cheval 350.00
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>db2_fetch_assoc</function></member>
<member><function>db2_fetch_both</function></member>
<member><function>db2_fetch_object</function></member>
<member><function>db2_fetch_row</function></member>
<member><function>db2_result</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
-->