diff --git a/reference/ibm_db2/functions/db2-fetch-array.xml b/reference/ibm_db2/functions/db2-fetch-array.xml new file mode 100644 index 0000000000..e77f5a2a2e --- /dev/null +++ b/reference/ibm_db2/functions/db2-fetch-array.xml @@ -0,0 +1,167 @@ + + + + + + db2_fetch_array + + Returns an array, indexed by column position, representing a row in a result set + + + + &reftitle.description; + + arraydb2_fetch_array + resourcestmt + introw_number + + + &warn.experimental.func; + + + Returns an array, indexed by column position, representing a row in a result + set. The columns are 0-indexed. + + + + + &reftitle.parameters; + + + + stmt + + + A valid stmt resource containing a result set. + + + + + row_number + + + Requests a specific 1-indexed row from the result set. Passing this + parameter results in a PHP warning if the result set uses a + forward-only cursor. + + + + + + + + &reftitle.returnvalues; + + Returns a 0-indexed array with column values indexed by the column position + representing the next or requested row in the result set. Returns &false; if + there are no rows left in the result set, or if the row requested by + row_number does not exist in the result set. + + + + + &reftitle.examples; + + + Iterating through a forward-only cursor + + If you call db2_fetch_array without a specific row + number, it automatically retrieves the next row in the result set. + + + +]]> + + &example.outputs; + + + + + + + Retrieving specific rows with <function>db2_fetch_assoc</function> + from a scrollable cursor + + If your result set uses a scrollable cursor, you can call + db2_fetch_assoc with a specific row number. The + following example retrieves every other row in the result set, starting + with the second row. + + + 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; +} +?> +]]> + + &example.outputs; + + + + + + + + + &reftitle.seealso; + + + db2_fetch_assoc + db2_fetch_both + db2_fetch_object + db2_fetch_row + db2_result + + + + + + +