Returns an array that corresponds to the fetched row, or
FALSE if there are no more
rows.
The number of columns in the result set is returned in
an associative array element $array["count"]. Because some of
the result columns may be empty, the count()
function can not be used on the result row returned by sesam_fetch_row().
result_id is a valid
result id returned by sesam_query() (select type queries
only!).
whence is an optional
parameter for a fetch operation on "scrollable" cursors,
which can be set to the following predefined constants:
表格 1. Valid values for
"whence" parameter
When using "scrollable" cursors, the cursor can be
freely positioned on the result set. If the whence parameter is omitted, the
global default values for the scrolling type (initialized to:
SESAM_SEEK_NEXT, and settable by
sesam_seek_row()) are used. If
whence is supplied, its value replaces the global
default.
offset is an optional
parameter which is only evaluated (and required) if whence is either SESAM_SEEK_RELATIVE or
SESAM_SEEK_ABSOLUTE. This parameter is only valid for
"scrollable" cursors.
sesam_fetch_row() fetches one
row of data from the result associated with the specified
result identifier. The row is returned as an array (indexed
by values between 0 and $array["count"]-1). Fields may be empty, so
you must check for the existence of a field by using the php
isset() function. The type of the returned fields
depend on the respective SQL type declared for its column
(see SESAM overview for the
conversions applied). SESAM "multiple fields" are "inlined"
and treated like a sequence of columns.
Subsequent calls to
sesam_fetch_row() would return the next (or prior, or
n'th next/prior, depending on the scroll attributes) row in
the result set, or FALSE if
there are no more rows.
See also: sesam_fetch_array() which returns an
associative array, and
sesam_fetch_result() which returns many rows per
invocation.