WordPress 4.4
[autoinstalls/wordpress.git] / wp-includes / pomo / streams.php
index 8ac94c35d6184b3c3b62dffbd6ecbc99eee155d7..5e37c9c41203900323261fbd119c3a3418e6e27b 100644 (file)
@@ -3,22 +3,32 @@
  * Classes, which help reading streams of data from files.
  * Based on the classes from Danilo Segan <danilo@kvota.net>
  *
- * @version $Id: streams.php 406 2010-02-07 11:10:24Z nbachiyski $
+ * @version $Id: streams.php 1157 2015-11-20 04:30:11Z dd32 $
  * @package pomo
  * @subpackage streams
  */
 
-if ( !class_exists( 'POMO_Reader' ) ):
+if ( ! class_exists( 'POMO_Reader', false ) ):
 class POMO_Reader {
 
        var $endian = 'little';
        var $_post = '';
 
-       function POMO_Reader() {
+       /**
+        * PHP5 constructor.
+        */
+       function __construct() {
                $this->is_overloaded = ((ini_get("mbstring.func_overload") & 2) != 0) && function_exists('mb_substr');
                $this->_pos = 0;
        }
 
+       /**
+        * PHP4 constructor.
+        */
+       public function POMO_Reader() {
+               self::__construct();
+       }
+
        /**
         * Sets the endianness of the file.
         *
@@ -40,7 +50,7 @@ class POMO_Reader {
                        return false;
                $endian_letter = ('big' == $this->endian)? 'N' : 'V';
                $int = unpack($endian_letter, $bytes);
-               return array_shift($int);
+               return reset( $int );
        }
 
        /**
@@ -58,7 +68,12 @@ class POMO_Reader {
                return unpack($endian_letter.$count, $bytes);
        }
 
-
+       /**
+        * @param string $string
+        * @param int    $start
+        * @param int    $length
+        * @return string
+        */
        function substr($string, $start, $length) {
                if ($this->is_overloaded) {
                        return mb_substr($string, $start, $length, 'ascii');
@@ -67,6 +82,10 @@ class POMO_Reader {
                }
        }
 
+       /**
+        * @param string $string
+        * @return int
+        */
        function strlen($string) {
                if ($this->is_overloaded) {
                        return mb_strlen($string, 'ascii');
@@ -75,6 +94,11 @@ class POMO_Reader {
                }
        }
 
+       /**
+        * @param string $string
+        * @param int    $chunk_size
+        * @return array
+        */
        function str_split($string, $chunk_size) {
                if (!function_exists('str_split')) {
                        $length = $this->strlen($string);
@@ -87,32 +111,58 @@ class POMO_Reader {
                }
        }
 
-
+       /**
+        * @return int
+        */
        function pos() {
                return $this->_pos;
        }
 
+       /**
+        * @return true
+        */
        function is_resource() {
                return true;
        }
 
+       /**
+        * @return true
+        */
        function close() {
                return true;
        }
 }
 endif;
 
-if ( !class_exists( 'POMO_FileReader' ) ):
+if ( ! class_exists( 'POMO_FileReader', false ) ):
 class POMO_FileReader extends POMO_Reader {
-       function POMO_FileReader($filename) {
+
+       /**
+        * @param string $filename
+        */
+       function __construct( $filename ) {
                parent::POMO_Reader();
-               $this->_f = fopen($filename, 'r');
+               $this->_f = fopen($filename, 'rb');
+       }
+
+       /**
+        * PHP4 constructor.
+        */
+       public function POMO_FileReader( $filename ) {
+               self::__construct( $filename );
        }
 
+       /**
+        * @param int $bytes
+        */
        function read($bytes) {
                return fread($this->_f, $bytes);
        }
 
+       /**
+        * @param int $pos
+        * @return boolean
+        */
        function seekto($pos) {
                if ( -1 == fseek($this->_f, $pos, SEEK_SET)) {
                        return false;
@@ -121,18 +171,30 @@ class POMO_FileReader extends POMO_Reader {
                return true;
        }
 
+       /**
+        * @return bool
+        */
        function is_resource() {
                return is_resource($this->_f);
        }
 
+       /**
+        * @return bool
+        */
        function feof() {
                return feof($this->_f);
        }
 
+       /**
+        * @return bool
+        */
        function close() {
                return fclose($this->_f);
        }
 
+       /**
+        * @return string
+        */
        function read_all() {
                $all = '';
                while ( !$this->feof() )
@@ -142,7 +204,7 @@ class POMO_FileReader extends POMO_Reader {
 }
 endif;
 
-if ( !class_exists( 'POMO_StringReader' ) ):
+if ( ! class_exists( 'POMO_StringReader', false ) ):
 /**
  * Provides file-like methods for manipulating a string instead
  * of a physical file.
@@ -151,13 +213,26 @@ class POMO_StringReader extends POMO_Reader {
 
        var $_str = '';
 
-       function POMO_StringReader($str = '') {
+       /**
+        * PHP5 constructor.
+        */
+       function __construct( $str = '' ) {
                parent::POMO_Reader();
                $this->_str = $str;
                $this->_pos = 0;
        }
 
+       /**
+        * PHP4 constructor.
+        */
+       public function POMO_StringReader( $str = '' ) {
+               self::__construct( $str );
+       }
 
+       /**
+        * @param string $bytes
+        * @return string
+        */
        function read($bytes) {
                $data = $this->substr($this->_str, $this->_pos, $bytes);
                $this->_pos += $bytes;
@@ -165,16 +240,26 @@ class POMO_StringReader extends POMO_Reader {
                return $data;
        }
 
+       /**
+        * @param int $pos
+        * @return int
+        */
        function seekto($pos) {
                $this->_pos = $pos;
                if ($this->strlen($this->_str) < $this->_pos) $this->_pos = $this->strlen($this->_str);
                return $this->_pos;
        }
 
+       /**
+        * @return int
+        */
        function length() {
                return $this->strlen($this->_str);
        }
 
+       /**
+        * @return string
+        */
        function read_all() {
                return $this->substr($this->_str, $this->_pos, $this->strlen($this->_str));
        }
@@ -182,28 +267,49 @@ class POMO_StringReader extends POMO_Reader {
 }
 endif;
 
-if ( !class_exists( 'POMO_CachedFileReader' ) ):
+if ( ! class_exists( 'POMO_CachedFileReader', false ) ):
 /**
  * Reads the contents of the file in the beginning.
  */
 class POMO_CachedFileReader extends POMO_StringReader {
-       function POMO_CachedFileReader($filename) {
+       /**
+        * PHP5 constructor.
+        */
+       function __construct( $filename ) {
                parent::POMO_StringReader();
                $this->_str = file_get_contents($filename);
                if (false === $this->_str)
                        return false;
                $this->_pos = 0;
        }
+
+       /**
+        * PHP4 constructor.
+        */
+       public function POMO_CachedFileReader( $filename ) {
+               self::__construct( $filename );
+       }
 }
 endif;
 
-if ( !class_exists( 'POMO_CachedIntFileReader' ) ):
+if ( ! class_exists( 'POMO_CachedIntFileReader', false ) ):
 /**
  * Reads the contents of the file in the beginning.
  */
 class POMO_CachedIntFileReader extends POMO_CachedFileReader {
-       function POMO_CachedIntFileReader($filename) {
+       /**
+        * PHP5 constructor.
+        */
+       public function __construct( $filename ) {
                parent::POMO_CachedFileReader($filename);
        }
+
+       /**
+        * PHP4 constructor.
+        */
+       function POMO_CachedIntFileReader( $filename ) {
+               self::__construct( $filename );
+       }
 }
-endif;
\ No newline at end of file
+endif;
+