Indicates whether the current row is positioned at the beginning of the cursor.

Syntax

---

edb_bof(<CursorHandle>)

<CursorHandle> =

Handle of cursor returned by edb_execute function

Returns

---

TRUE if the current row is at BOF, or
FALSE if not (or if there are any errors)

Usage

---

The edb_bof function returns the whether the current row is positioned at the beginning of the cursor. The BOF (Beginning Of File) flag indicates that the current row has been positioned at the beginning of the cursor using the edb_first function, or an attempt has been made to navigate past the beginning of the cursor using the edb_prior function.

Examples

---

<?php

// The following script connects to an ElevateDB
// Server and database, prepares and executes a
// direct table open, goes to the end of the cursor,
// and navigates to the beginning of the cursor
// by using the edb_bof() function to test when to
// stop navigating

$con = edb_connect("type=remote;charset=Ansi;address=127.0.0.1;"+
                   "uid=Administrator;pwd=EDBDefault;database=Test");
if (!$con)
  {
  die("Could not connect: " . edb_errmsg());
  }

$cmd = edb_prepare($con,"customer",EDB_COMMAND_TABLE);
$cursor = edb_execute($cmd);

edb_last($cursor);

while (!edb_bof($cursor)):
   edb_prior($cursor);
endwhile;

echo edb_state($cursor);

edb_disconnect($con);
?>