/**
* Rewinds to the beginning of the file
*
- * @return $status Status of this operation
+ * @return $status Status of this operation
*/
function rewind ();
+
+ /**
+ * Advances to next "block" of bytes
+ *
+ * @return void
+ * @todo This method will load large but empty files in a whole
+ */
+ function next ();
+
+ /**
+ * Checks wether the current entry is valid (not at the end of the file).
+ * This method will return TRUE if an emptied (nulled) entry has been found.
+ *
+ * @return $isValid Whether the next entry is valid
+ */
+ function valid ();
+
+ /**
+ * Gets current seek position ("key").
+ *
+ * @return $key Current key in iteration
+ */
+ function key ();
}
// [EOF]