mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-28 16:49:40 +02:00
This commit adds the `public` visibility keyword to each method which did not have an explicit visibility keyword. Why `public`? With no visibility previously declared, these methods are implicitly `public` and available for use. Changing them to anything else would be a backwards-compatibility break. Props costdev, jrf. See #54177. Built from https://develop.svn.wordpress.org/trunk@51919 git-svn-id: http://core.svn.wordpress.org/trunk@51512 1a063a9b-81f0-0310-95a4-ce76da25c4cd
358 lines
7.6 KiB
PHP
358 lines
7.6 KiB
PHP
<?php
|
|
/**
|
|
* Classes, which help reading streams of data from files.
|
|
* Based on the classes from Danilo Segan <danilo@kvota.net>
|
|
*
|
|
* @version $Id: streams.php 1157 2015-11-20 04:30:11Z dd32 $
|
|
* @package pomo
|
|
* @subpackage streams
|
|
*/
|
|
|
|
if ( ! class_exists( 'POMO_Reader', false ) ) :
|
|
class POMO_Reader {
|
|
|
|
public $endian = 'little';
|
|
public $_post = '';
|
|
|
|
/**
|
|
* PHP5 constructor.
|
|
*/
|
|
public function __construct() {
|
|
if ( function_exists( 'mb_substr' )
|
|
&& ( (int) ini_get( 'mbstring.func_overload' ) & 2 ) // phpcs:ignore PHPCompatibility.IniDirectives.RemovedIniDirectives.mbstring_func_overloadDeprecated
|
|
) {
|
|
$this->is_overloaded = true;
|
|
} else {
|
|
$this->is_overloaded = false;
|
|
}
|
|
|
|
$this->_pos = 0;
|
|
}
|
|
|
|
/**
|
|
* PHP4 constructor.
|
|
*
|
|
* @deprecated 5.4.0 Use __construct() instead.
|
|
*
|
|
* @see POMO_Reader::__construct()
|
|
*/
|
|
public function POMO_Reader() {
|
|
_deprecated_constructor( self::class, '5.4.0', static::class );
|
|
self::__construct();
|
|
}
|
|
|
|
/**
|
|
* Sets the endianness of the file.
|
|
*
|
|
* @param string $endian Set the endianness of the file. Accepts 'big', or 'little'.
|
|
*/
|
|
public function setEndian( $endian ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.MethodNameInvalid
|
|
$this->endian = $endian;
|
|
}
|
|
|
|
/**
|
|
* Reads a 32bit Integer from the Stream
|
|
*
|
|
* @return mixed The integer, corresponding to the next 32 bits from
|
|
* the stream of false if there are not enough bytes or on error
|
|
*/
|
|
public function readint32() {
|
|
$bytes = $this->read( 4 );
|
|
if ( 4 != $this->strlen( $bytes ) ) {
|
|
return false;
|
|
}
|
|
$endian_letter = ( 'big' === $this->endian ) ? 'N' : 'V';
|
|
$int = unpack( $endian_letter, $bytes );
|
|
return reset( $int );
|
|
}
|
|
|
|
/**
|
|
* Reads an array of 32-bit Integers from the Stream
|
|
*
|
|
* @param int $count How many elements should be read
|
|
* @return mixed Array of integers or false if there isn't
|
|
* enough data or on error
|
|
*/
|
|
public function readint32array( $count ) {
|
|
$bytes = $this->read( 4 * $count );
|
|
if ( 4 * $count != $this->strlen( $bytes ) ) {
|
|
return false;
|
|
}
|
|
$endian_letter = ( 'big' === $this->endian ) ? 'N' : 'V';
|
|
return unpack( $endian_letter . $count, $bytes );
|
|
}
|
|
|
|
/**
|
|
* @param string $string
|
|
* @param int $start
|
|
* @param int $length
|
|
* @return string
|
|
*/
|
|
public function substr( $string, $start, $length ) {
|
|
if ( $this->is_overloaded ) {
|
|
return mb_substr( $string, $start, $length, 'ascii' );
|
|
} else {
|
|
return substr( $string, $start, $length );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param string $string
|
|
* @return int
|
|
*/
|
|
public function strlen( $string ) {
|
|
if ( $this->is_overloaded ) {
|
|
return mb_strlen( $string, 'ascii' );
|
|
} else {
|
|
return strlen( $string );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param string $string
|
|
* @param int $chunk_size
|
|
* @return array
|
|
*/
|
|
public function str_split( $string, $chunk_size ) {
|
|
if ( ! function_exists( 'str_split' ) ) {
|
|
$length = $this->strlen( $string );
|
|
$out = array();
|
|
for ( $i = 0; $i < $length; $i += $chunk_size ) {
|
|
$out[] = $this->substr( $string, $i, $chunk_size );
|
|
}
|
|
return $out;
|
|
} else {
|
|
return str_split( $string, $chunk_size );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function pos() {
|
|
return $this->_pos;
|
|
}
|
|
|
|
/**
|
|
* @return true
|
|
*/
|
|
public function is_resource() {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @return true
|
|
*/
|
|
public function close() {
|
|
return true;
|
|
}
|
|
}
|
|
endif;
|
|
|
|
if ( ! class_exists( 'POMO_FileReader', false ) ) :
|
|
class POMO_FileReader extends POMO_Reader {
|
|
|
|
/**
|
|
* @param string $filename
|
|
*/
|
|
public function __construct( $filename ) {
|
|
parent::__construct();
|
|
$this->_f = fopen( $filename, 'rb' );
|
|
}
|
|
|
|
/**
|
|
* PHP4 constructor.
|
|
*
|
|
* @deprecated 5.4.0 Use __construct() instead.
|
|
*
|
|
* @see POMO_FileReader::__construct()
|
|
*/
|
|
public function POMO_FileReader( $filename ) {
|
|
_deprecated_constructor( self::class, '5.4.0', static::class );
|
|
self::__construct( $filename );
|
|
}
|
|
|
|
/**
|
|
* @param int $bytes
|
|
* @return string|false Returns read string, otherwise false.
|
|
*/
|
|
public function read( $bytes ) {
|
|
return fread( $this->_f, $bytes );
|
|
}
|
|
|
|
/**
|
|
* @param int $pos
|
|
* @return bool
|
|
*/
|
|
public function seekto( $pos ) {
|
|
if ( -1 == fseek( $this->_f, $pos, SEEK_SET ) ) {
|
|
return false;
|
|
}
|
|
$this->_pos = $pos;
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function is_resource() {
|
|
return is_resource( $this->_f );
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function feof() {
|
|
return feof( $this->_f );
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function close() {
|
|
return fclose( $this->_f );
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function read_all() {
|
|
$all = '';
|
|
while ( ! $this->feof() ) {
|
|
$all .= $this->read( 4096 );
|
|
}
|
|
return $all;
|
|
}
|
|
}
|
|
endif;
|
|
|
|
if ( ! class_exists( 'POMO_StringReader', false ) ) :
|
|
/**
|
|
* Provides file-like methods for manipulating a string instead
|
|
* of a physical file.
|
|
*/
|
|
class POMO_StringReader extends POMO_Reader {
|
|
|
|
public $_str = '';
|
|
|
|
/**
|
|
* PHP5 constructor.
|
|
*/
|
|
public function __construct( $str = '' ) {
|
|
parent::__construct();
|
|
$this->_str = $str;
|
|
$this->_pos = 0;
|
|
}
|
|
|
|
/**
|
|
* PHP4 constructor.
|
|
*
|
|
* @deprecated 5.4.0 Use __construct() instead.
|
|
*
|
|
* @see POMO_StringReader::__construct()
|
|
*/
|
|
public function POMO_StringReader( $str = '' ) {
|
|
_deprecated_constructor( self::class, '5.4.0', static::class );
|
|
self::__construct( $str );
|
|
}
|
|
|
|
/**
|
|
* @param string $bytes
|
|
* @return string
|
|
*/
|
|
public function read( $bytes ) {
|
|
$data = $this->substr( $this->_str, $this->_pos, $bytes );
|
|
$this->_pos += $bytes;
|
|
if ( $this->strlen( $this->_str ) < $this->_pos ) {
|
|
$this->_pos = $this->strlen( $this->_str );
|
|
}
|
|
return $data;
|
|
}
|
|
|
|
/**
|
|
* @param int $pos
|
|
* @return int
|
|
*/
|
|
public function seekto( $pos ) {
|
|
$this->_pos = $pos;
|
|
if ( $this->strlen( $this->_str ) < $this->_pos ) {
|
|
$this->_pos = $this->strlen( $this->_str );
|
|
}
|
|
return $this->_pos;
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function length() {
|
|
return $this->strlen( $this->_str );
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function read_all() {
|
|
return $this->substr( $this->_str, $this->_pos, $this->strlen( $this->_str ) );
|
|
}
|
|
|
|
}
|
|
endif;
|
|
|
|
if ( ! class_exists( 'POMO_CachedFileReader', false ) ) :
|
|
/**
|
|
* Reads the contents of the file in the beginning.
|
|
*/
|
|
class POMO_CachedFileReader extends POMO_StringReader {
|
|
/**
|
|
* PHP5 constructor.
|
|
*/
|
|
public function __construct( $filename ) {
|
|
parent::__construct();
|
|
$this->_str = file_get_contents( $filename );
|
|
if ( false === $this->_str ) {
|
|
return false;
|
|
}
|
|
$this->_pos = 0;
|
|
}
|
|
|
|
/**
|
|
* PHP4 constructor.
|
|
*
|
|
* @deprecated 5.4.0 Use __construct() instead.
|
|
*
|
|
* @see POMO_CachedFileReader::__construct()
|
|
*/
|
|
public function POMO_CachedFileReader( $filename ) {
|
|
_deprecated_constructor( self::class, '5.4.0', static::class );
|
|
self::__construct( $filename );
|
|
}
|
|
}
|
|
endif;
|
|
|
|
if ( ! class_exists( 'POMO_CachedIntFileReader', false ) ) :
|
|
/**
|
|
* Reads the contents of the file in the beginning.
|
|
*/
|
|
class POMO_CachedIntFileReader extends POMO_CachedFileReader {
|
|
/**
|
|
* PHP5 constructor.
|
|
*/
|
|
public function __construct( $filename ) {
|
|
parent::__construct( $filename );
|
|
}
|
|
|
|
/**
|
|
* PHP4 constructor.
|
|
*
|
|
* @deprecated 5.4.0 Use __construct() instead.
|
|
*
|
|
* @see POMO_CachedIntFileReader::__construct()
|
|
*/
|
|
public function POMO_CachedIntFileReader( $filename ) {
|
|
_deprecated_constructor( self::class, '5.4.0', static::class );
|
|
self::__construct( $filename );
|
|
}
|
|
}
|
|
endif;
|
|
|