Continued CSV parsing:
[core.git] / inc / classes / interfaces / io / pointer / class_InputPointer.php
index 35760ce05582a0390dbc83435218a288b9054529..c38cdd5bd755185f82c6d1342f30a1bae9f4e11c 100644 (file)
  * 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, Pointer {
+interface InputPointer extends StreamableInput, FilePointer {
        /**
         * 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 ();
 
+       /**
+        * 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
+        * @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
         */
-       function read ($bytes);
+       function read ($bytes = NULL);
 }
 
 // [EOF]