Continued CSV parsing:
[core.git] / inc / classes / interfaces / io / pointer / class_InputPointer.php
index 0c15cc7..c38cdd5 100644 (file)
@@ -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
  *
  * 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()
-        * @throws      NullPointerException    If the file pointer instance
-        *                                                                      is not set by setPointer()
-        * @throws      InvalidResourceException        If there is being set
+        * @return      $data   Read data from file
         */
        function readFromFile ();
 
         */
        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.
         *
        /**
         * Reads given amount of bytes from file.
         *
-        * @param       $bytes  Amount of bytes to read
+        * @param       $bytes  Amount of bytes to read or whole line (only text files)
         * @return      $data   Data read from file
         * @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
         */
         */
-       function read ($bytes);
+       function read ($bytes = NULL);
 }
 
 // [EOF]
 }
 
 // [EOF]