Continued with file-based stacks and file i/o:
[core.git] / inc / classes / interfaces / io / class_Streamable.php
index 68165ce6c81c1a198e9764a0468412b9e7f55b1a..7503dba4f03fad87333647e4b944ea39f1d825b2 100644 (file)
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 interface Streamable extends FrameworkInterface {
+       /**
+        * "Getter" for seek position
+        *
+        * @return      $seekPosition   Current seek position
+        */
+       function getPosition ();
+
+       /**
+        * Seek to given offset (default) or other possibilities as fseek() gives.
+        *
+        * @param       $offset         Offset to seek to (or used as "base" for other seeks)
+        * @param       $whence         Added to offset (default: only use offset to seek to)
+        * @return      $status         Status of file seek: 0 = success, -1 = failed
+        */
+       function seek ($offset, $whence = SEEK_SET);
+
+       /**
+        * Size of file stack
+        *
+        * @return      $size   Size (in bytes) of file
+        */
+       function size ();
 }
 
 // [EOF]