Begin Refactor

vendor/gabordemooij/redbean/RedBeanPHP/Cursor.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace RedBeanPHP;
+
+/**
+ * Database Cursor Interface.
+ * A cursor is used by Query Writers to fetch Query Result rows
+ * one row at a time. This is useful if you expect the result set to
+ * be quite large. This interface dscribes the API of a database
+ * cursor. There can be multiple implementations of the Cursor,
+ * by default RedBeanPHP offers the PDOCursor for drivers shipping
+ * with RedBeanPHP and the NULLCursor.
+ *
+ * @file    RedBeanPHP/Cursor.php
+ * @author  Gabor de Mooij and the RedBeanPHP Community
+ * @license BSD/GPLv2
+ *
+ * @copyright
+ * copyright (c) G.J.G.T. (Gabor) de Mooij and the RedBeanPHP Community
+ * This source file is subject to the BSD/GPLv2 License that is bundled
+ * with this source code in the file license.txt.
+ */
+interface Cursor
+{
+	/**
+	 * Should retrieve the next row of the result set.
+	 * This method is used to iterate over the result set.
+	 *
+	 * @return array
+	 */
+	public function getNextItem();
+
+	/**
+	 * Resets the cursor by closing it and re-executing the statement.
+	 * This reloads fresh data from the database for the whole collection.
+	 *
+	 * @return void
+	 */
+	public function reset();
+
+	/**
+	 * Closes the database cursor.
+	 * Some databases require a cursor to be closed before executing
+	 * another statement/opening a new cursor.
+	 *
+	 * @return void
+	 */
+	public function close();
+}