*
* @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
*
* 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]