Continued CSV parsing:

[core.git] / inc / classes / interfaces / io / pointer / class_InputPointer.php

diff --git a/inc/classes/interfaces/io/pointer/class_InputPointer.php b/inc/classes/interfaces/io/pointer/class_InputPointer.php
index 1d67cd24599fb3ba1b66e2bad501fdf510adb6eb..c38cdd5bd755185f82c6d1342f30a1bae9f4e11c 100644 (file)
--- a/inc/classes/interfaces/io/pointer/class_InputPointer.php
+++ b/inc/classes/interfaces/io/pointer/class_InputPointer.php
@@ -4,7 +4,7 @@
  *
  * @author             Roland Haeder <webmaster@shipsimu.org>
  * @version            0.0.0
  *
  * @author             Roland Haeder <webmaster@shipsimu.org>
  * @version            0.0.0

- * @copyright  Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2013 Core Developer Team
+ * @copyright  Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2014 Core Developer Team

  * @license            GNU GPL 3.0 or any newer version
  * @link               http://www.shipsimu.org
  *
  * @license            GNU GPL 3.0 or any newer version
  * @link               http://www.shipsimu.org
  *


@@ -21,16 +21,31 @@
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */

-interface InputPointer extends StreamableInput {
+interface InputPointer extends StreamableInput, FilePointer {

        /**
         * Read data a file pointer
         *
        /**
         * Read data a file pointer
         *

-        * @return      mixed   The result of fread()
+        * @return      $data   Read data from file
+        */
+       function readFromFile ();
+
+       /**
+        * Reads a line, maximum 4096 Bytes from current file pointer
+        *
+        * @return      $data   Read data from file
+        */
+       function readLine ();
+
+       /**
+        * Reads given amount of bytes from file.
+        *
+        * @param       $bytes  Amount of bytes to read or whole line (only text files)
+        * @return      $data   Data read from file

         * @throws      NullPointerException    If the file pointer instance
         *                                                                      is not set by setPointer()
         * @throws      InvalidResourceException        If there is being set
         */
         * @throws      NullPointerException    If the file pointer instance
         *                                                                      is not set by setPointer()
         * @throws      InvalidResourceException        If there is being set
         */

-       function readFromFile ();
+       function read ($bytes = NULL);

 }
 
 // [EOF]
 }
 
 // [EOF]