fbsql_data_seek

(PHP 4 >= 4.0.6)

fbsql_data_seek -- Move internal result pointer

Description

bool fbsql_data_seek ( resource result_identifier, int row_number)

Returns TRUE on success or FALSE on failure.

fbsql_data_seek() moves the internal row pointer of the FrontBase result associated with the specified result identifier to point to the specified row number. The next call to fbsql_fetch_row() would return that row.

Row_number starts at 0.

Example 1. fbsql_data_seek() example

<?php
    $link
= fbsql_pconnect ("localhost", "_SYSTEM", "secret")
        or die (
"Could not connect");

    
fbsql_select_db ("samp_db")
        or die (
"Could not select database");

    
$query = "SELECT last_name, first_name FROM friends;";
    
$result = fbsql_query ($query)
        or die (
"Query failed");

    
# fetch rows in reverse order

    
for ($i = fbsql_num_rows ($result) - 1; $i >=0; $i--) {
        if (!
fbsql_data_seek ($result, $i)) {
            
printf ("Cannot seek to row %d\n", $i);
            continue;
        }

        if(!(
$row = fbsql_fetch_object ($result)))
            continue;

        
printf("%s %s<BR>\n", $row->last_name, $row->first_name);
    }

    
fbsql_free_result ($result);
?>