powerdlz23 1.1.7 → 1.1.8

package/pto/yaamp/web/framework-1.0.8/i18n/CNumberFormatter.php

@@ -0,0 +1,280 @@
+<?php
+/**
+ * CNumberFormatter class file.
+ *
+ * @author Wei Zhuo <weizhuo[at]gmail[dot]com>
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CNumberFormatter provides number localization functionalities.
+ *
+ * CNumberFormatter formats a number (integer or double) and outputs a string
+ * based on the specified format. A CNumberFormatter instance is associated with a locale,
+ * and thus generates the string representation of the number in a locale-dependent fashion.
+ *
+ * CNumberFormatter currently supports currency format, percentage format, decimal format,
+ * and custom format. The first three formats are specified in the locale data, while the custom
+ * format allows you to enter an arbitrary format string.
+ *
+ * A format string may consist of the following special characters:
+ * <ul>
+ * <li>dot (.): the decimal point. It will be replaced with the localized decimal point.</li>
+ * <li>comma (,): the grouping separator. It will be replaced with the localized grouping separator.</li>
+ * <li>zero (0): required digit. This specifies the places where a digit must appear (will pad 0 if not).</li>
+ * <li>hash (#): optional digit. This is mainly used to specify the location of decimal point and grouping separators.</li>
+ * <li>currency (¤): the currency placeholder. It will be replaced with the localized currency symbol.</li>
+ * <li>percentage (%): the percetage mark. If appearing, the number will be multiplied by 100 before being formatted.</li>
+ * <li>permillage (‰): the permillage mark. If appearing, the number will be multiplied by 1000 before being formatted.</li>
+ * <li>semicolon (;): the character separating positive and negative number sub-patterns.</li>
+ * </ul>
+ *
+ * Anything surrounding the pattern (or sub-patterns) will be kept.
+ *
+ * The followings are some examples:
+ * <pre>
+ * Pattern "#,##0.00" will format 12345.678 as "12,345.68".
+ * Pattern "#,#,#0.00" will format 12345.6 as "1,2,3,45.60".
+ * </pre>
+ * Note, in the first example, the number is rounded first before applying the formatting.
+ * And in the second example, the pattern specifies two grouping sizes.
+ *
+ * CNumberFormatter attempts to implement number formatting according to
+ * the {@link http://www.unicode.org/reports/tr35/ Unicode Technical Standard #35}.
+ * The following features are NOT implemented:
+ * <ul>
+ * <li>significant digit</li>
+ * <li>scientific format</li>
+ * <li>arbitrary literal characters</li>
+ * <li>arbitrary padding</li>
+ * </ul>
+ *
+ * @author Wei Zhuo <weizhuo[at]gmail[dot]com>
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CNumberFormatter.php 1262 2009-07-21 19:00:55Z qiang.xue $
+ * @package system.i18n
+ * @since 1.0
+ */
+class CNumberFormatter extends CComponent
+{
+	private $_locale;
+	private $_formats=array();
+
+	/**
+	 * Constructor.
+	 * @param mixed locale ID (string) or CLocale instance
+	 */
+	public function __construct($locale)
+	{
+		if(is_string($locale))
+			$this->_locale=CLocale::getInstance($locale);
+		else
+			$this->_locale=$locale;
+	}
+
+	/**
+	 * Formats a number based on the specified pattern.
+	 * Note, if the format contains '%', the number will be multiplied by 100 first.
+	 * If the format contains '‰', the number will be multiplied by 1000.
+	 * If the format contains currency placeholder, it will be replaced by
+	 * the specified localized currency symbol.
+	 * @param string format pattern
+	 * @param mixed the number to be formatted
+	 * @param string 3-letter ISO 4217 code. For example, the code "USD" represents the US Dollar and "EUR" represents the Euro currency.
+	 * The currency placeholder in the pattern will be replaced with the currency symbol.
+	 * If null, no replacement will be done.
+	 * @return string the formatting result.
+	 */
+	public function format($pattern,$value,$currency=null)
+	{
+		$format=$this->parseFormat($pattern);
+		$result=$this->formatNumber($format,$value);
+		if($currency===null)
+			return $result;
+		else if(($symbol=$this->_locale->getCurrencySymbol($currency))===null)
+			$symbol=$currency;
+		return str_replace('¤',$symbol,$result);
+	}
+
+	/**
+	 * Formats a number using the currency format defined in the locale.
+	 * @param mixed the number to be formatted
+	 * @param string 3-letter ISO 4217 code. For example, the code "USD" represents the US Dollar and "EUR" represents the Euro currency.
+	 * The currency placeholder in the pattern will be replaced with the currency symbol.
+	 * @return string the formatting result.
+	 */
+	public function formatCurrency($value,$currency)
+	{
+		return $this->format($this->_locale->getCurrencyFormat(),$value,$currency);
+	}
+
+	/**
+	 * Formats a number using the percentage format defined in the locale.
+	 * Note, if the percentage format contains '%', the number will be multiplied by 100 first.
+	 * If the percentage format contains '‰', the number will be multiplied by 1000.
+	 * @param mixed the number to be formatted
+	 * @return string the formatting result.
+	 */
+	public function formatPercentage($value)
+	{
+		return $this->format($this->_locale->getPercentFormat(),$value);
+	}
+
+	/**
+	 * Formats a number using the decimal format defined in the locale.
+	 * @param mixed the number to be formatted
+	 * @return string the formatting result.
+	 */
+	public function formatDecimal($value)
+	{
+		return $this->format($this->_locale->getDecimalFormat(),$value);
+	}
+
+	/**
+	 * Formats a number based on a format.
+	 * This is the method that does actual number formatting.
+	 * @param array format with the following structure:
+	 * <pre>
+	 * array(
+	 * 	'decimalDigits'=>2,     // number of required digits after decimal point; 0s will be padded if not enough digits; if -1, it means we should drop decimal point
+	 *  'maxDecimalDigits'=>3,  // maximum number of digits after decimal point. Additional digits will be truncated.
+	 * 	'integerDigits'=>1,     // number of required digits before decimal point; 0s will be padded if not enough digits
+	 * 	'groupSize1'=>3,        // the primary grouping size; if 0, it means no grouping
+	 * 	'groupSize2'=>0,        // the secondary grouping size; if 0, it means no secondary grouping
+	 * 	'positivePrefix'=>'+',  // prefix to positive number
+	 * 	'positiveSuffix'=>'',   // suffix to positive number
+	 * 	'negativePrefix'=>'(',  // prefix to negative number
+	 * 	'negativeSuffix'=>')',  // suffix to negative number
+	 * 	'multiplier'=>1,        // 100 for percent, 1000 for per mille
+	 * );
+	 * </pre>
+	 * @param mixed the number to be formatted
+	 * @return string the formatted result
+	 */
+	protected function formatNumber($format,$value)
+	{
+		$negative=$value<0;
+		$value=abs($value*$format['multiplier']);
+		if($format['maxDecimalDigits']>=0)
+			$value=round($value,$format['maxDecimalDigits']);
+		$value="$value";
+		if(($pos=strpos($value,'.'))!==false)
+		{
+			$integer=substr($value,0,$pos);
+			$decimal=substr($value,$pos+1);
+		}
+		else
+		{
+			$integer=$value;
+			$decimal='';
+		}
+
+		if($format['decimalDigits']>strlen($decimal))
+			$decimal=str_pad($decimal,$format['decimalDigits'],'0');
+		if(strlen($decimal)>0)
+			$decimal=$this->_locale->getNumberSymbol('decimal').$decimal;
+
+		$integer=str_pad($integer,$format['integerDigits'],'0',STR_PAD_LEFT);
+		if($format['groupSize1']>0 && strlen($integer)>$format['groupSize1'])
+		{
+			$str1=substr($integer,0,-$format['groupSize1']);
+			$str2=substr($integer,-$format['groupSize1']);
+			$size=$format['groupSize2']>0?$format['groupSize2']:$format['groupSize1'];
+			$str1=str_pad($str1,(int)((strlen($str1)+$size-1)/$size)*$size,' ',STR_PAD_LEFT);
+			$integer=ltrim(implode($this->_locale->getNumberSymbol('group'),str_split($str1,$size))).$this->_locale->getNumberSymbol('group').$str2;
+		}
+
+		if($negative)
+			$number=$format['negativePrefix'].$integer.$decimal.$format['negativeSuffix'];
+		else
+			$number=$format['positivePrefix'].$integer.$decimal.$format['positiveSuffix'];
+
+		return strtr($number,array('%'=>$this->_locale->getNumberSymbol('percentSign'),'‰'=>$this->_locale->getNumberSymbol('perMille')));
+	}
+
+	/**
+	 * Parses a given string pattern.
+	 * @param string the pattern to be parsed
+	 * @return array the parsed pattern
+	 * @see formatNumber
+	 */
+	protected function parseFormat($pattern)
+	{
+		if(isset($this->_formats[$pattern]))
+			return $this->_formats[$pattern];
+
+		$format=array();
+
+		// find out prefix and suffix for positive and negative patterns
+		$patterns=explode(';',$pattern);
+		$format['positivePrefix']=$format['positiveSuffix']=$format['negativePrefix']=$format['negativeSuffix']='';
+		if(preg_match('/^(.*?)[#,\.0]+(.*?)$/',$patterns[0],$matches))
+		{
+			$format['positivePrefix']=$matches[1];
+			$format['positiveSuffix']=$matches[2];
+		}
+
+		if(isset($patterns[1]) && preg_match('/^(.*?)[#,\.0]+(.*?)$/',$patterns[1],$matches))  // with a negative pattern
+		{
+			$format['negativePrefix']=$matches[1];
+			$format['negativeSuffix']=$matches[2];
+		}
+		else
+		{
+			$format['negativePrefix']=$this->_locale->getNumberSymbol('minusSign').$format['positivePrefix'];
+			$format['negativeSuffix']=$format['positiveSuffix'];
+		}
+		$pat=$patterns[0];
+
+		// find out multiplier
+		if(strpos($pat,'%')!==false)
+			$format['multiplier']=100;
+		else if(strpos($pat,'‰')!==false)
+			$format['multiplier']=1000;
+		else
+			$format['multiplier']=1;
+
+		// find out things about decimal part
+		if(($pos=strpos($pat,'.'))!==false)
+		{
+			if(($pos2=strrpos($pat,'0'))>$pos)
+				$format['decimalDigits']=$pos2-$pos;
+			else
+				$format['decimalDigits']=0;
+			if(($pos3=strrpos($pat,'#'))>=$pos2)
+				$format['maxDecimalDigits']=$pos3-$pos;
+			else
+				$format['maxDecimalDigits']=$format['decimalDigits'];
+			$pat=substr($pat,0,$pos);
+		}
+		else   // no decimal part
+		{
+			$format['decimalDigits']=0;
+			$format['maxDecimalDigits']=0;
+		}
+
+		// find out things about integer part
+		$p=str_replace(',','',$pat);
+		if(($pos=strpos($p,'0'))!==false)
+			$format['integerDigits']=strrpos($p,'0')-$pos+1;
+		else
+			$format['integerDigits']=0;
+		// find out group sizes. some patterns may have two different group sizes
+		$p=str_replace('#','0',$pat);
+		if(($pos=strrpos($pat,','))!==false)
+		{
+			$format['groupSize1']=strrpos($p,'0')-$pos;
+			if(($pos2=strrpos(substr($p,0,$pos),','))!==false)
+				$format['groupSize2']=$pos-$pos2-1;
+			else
+				$format['groupSize2']=0;
+		}
+		else
+			$format['groupSize1']=$format['groupSize2']=0;
+
+		return $this->_formats[$pattern]=$format;
+	}
+}

package/pto/yaamp/web/framework-1.0.8/i18n/CPhpMessageSource.php

@@ -0,0 +1,96 @@
+<?php
+/**
+ * CPhpMessageSource class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CPhpMessageSource represents a message source that stores translated messages in PHP scripts.
+ *
+ * CPhpMessageSource uses PHP files and arrays to keep message translations.
+ * <ul>
+ * <li>All translations are saved under the {@link basePath} directory.</li>
+ * <li>Translations in one language are kept as PHP files under an individual subdirectory
+ *   whose name is the same as the language ID. Each PHP file contains messages
+ *   belonging to the same category, and the file name is the same as the category name.</li>
+ * <li>Within a PHP file, an array of (source, translation) pairs is returned.
+ * For example:
+ * <pre>
+ * return array(
+ *     'original message 1' => 'translated message 1',
+ *     'original message 2' => 'translated message 2',
+ * );
+ * </pre>
+ * </li>
+ * </ul>
+ * When {@link cachingDuration} is set as a positive number, message translations will be cached.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CPhpMessageSource.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.i18n
+ * @since 1.0
+ */
+class CPhpMessageSource extends CMessageSource
+{
+	const CACHE_KEY_PREFIX='Yii.CPhpMessageSource.';
+
+	/**
+	 * @var integer the time in seconds that the messages can remain valid in cache.
+	 * Defaults to 0, meaning the caching is disabled.
+	 */
+	public $cachingDuration=0;
+	/**
+	 * @var string the base path for all translated messages. Defaults to null, meaning
+	 * the "messages" subdirectory of the application directory (e.g. "protected/messages").
+	 */
+	public $basePath;
+
+	/**
+	 * Initializes the application component.
+	 * This method overrides the parent implementation by preprocessing
+	 * the user request data.
+	 */
+	public function init()
+	{
+		parent::init();
+		if($this->basePath===null)
+			$this->basePath=Yii::getPathOfAlias('application.messages');
+	}
+
+	/**
+	 * Loads the message translation for the specified language and category.
+	 * @param string the message category
+	 * @param string the target language
+	 * @return array the loaded messages
+	 */
+	protected function loadMessages($category,$language)
+	{
+		$messageFile=$this->basePath.DIRECTORY_SEPARATOR.$language.DIRECTORY_SEPARATOR.$category.'.php';
+
+		if($this->cachingDuration>0 && ($cache=Yii::app()->getCache())!==null)
+		{
+			$key=self::CACHE_KEY_PREFIX . $messageFile;
+			if(($data=$cache->get($key))!==false)
+				return unserialize($data);
+		}
+
+		if(is_file($messageFile))
+		{
+			$messages=include($messageFile);
+			if(!is_array($messages))
+				$messages=array();
+			if(isset($cache))
+			{
+				$dependency=new CFileCacheDependency($messageFile);
+				$cache->set($key,serialize($messages),$this->cachingDuration,$dependency);
+			}
+			return $messages;
+		}
+		else
+			return array();
+	}
+}

package/pto/yaamp/web/framework-1.0.8/i18n/gettext/CGettextFile.php

@@ -0,0 +1,36 @@
+<?php
+/**
+ * CGettextFile class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CGettextFile is the base class for representing a Gettext message file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CGettextFile.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.i18n.gettext
+ * @since 1.0
+ */
+abstract class CGettextFile extends CComponent
+{
+	/**
+	 * Loads messages from a file.
+	 * @param string file path
+	 * @param string message context
+	 * @return array message translations (source message => translated message)
+	 */
+	abstract public function load($file,$context);
+	/**
+	 * Saves messages to a file.
+	 * @param string file path
+	 * @param array message translations (message id => translated message).
+	 * Note if the message has a context, the message id must be prefixed with
+	 * the context with chr(4) as the separator.
+	 */
+	abstract public function save($file,$messages);
+}

package/pto/yaamp/web/framework-1.0.8/i18n/gettext/CGettextMoFile.php

@@ -0,0 +1,269 @@
+<?php
+/**
+ * CGettextMoFile class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CGettextMoFile represents an MO Gettext message file.
+ *
+ * This class is written by adapting Michael's Gettext_MO class in PEAR.
+ * Please refer to the following license terms.
+ *
+ * Copyright (c) 2004-2005, Michael Wallner <mike@iworks.at>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ *     * Redistributions of source code must retain the above copyright notice,
+ *       this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above copyright
+ *       notice, this list of conditions and the following disclaimer in the
+ *       documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CGettextMoFile.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.i18n.gettext
+ * @since 1.0
+ */
+class CGettextMoFile extends CGettextFile
+{
+	/**
+	 * @var boolean whether to use Big Endian when reading and writing an integer.
+	 */
+	public $useBigEndian=false;
+
+	/**
+	 * Constructor.
+	 * @param boolean whether to use Big Endian when reading and writing an integer.
+	 */
+	public function __construct($useBigEndian=false)
+	{
+		$this->useBigEndian=$useBigEndian;
+	}
+
+	/**
+	 * Loads messages from an MO file.
+	 * @param string file path
+	 * @param string message context
+	 * @return array message translations (source message => translated message)
+	 */
+	public function load($file,$context)
+	{
+		if(!($fr=@fopen($file,'rb')))
+			throw new CException(Yii::t('yii','Unable to read file "{file}".',
+				array('{file}'=>$file)));
+
+		if(!@flock($fr,LOCK_SH))
+			throw new CException(Yii::t('yii','Unable to lock file "{file}" for reading.',
+				array('{file}'=>$file)));
+
+		$magic=current($array=unpack('c',$this->readByte($fr,4)));
+		if($magic==-34)
+			$this->useBigEndian=false;
+		else if($magic==-107)
+			$this->useBigEndian=true;
+		else
+			throw new CException(Yii::t('yii','Invalid MO file: {file} (magic: {magic}).',
+				array('{file}'=>$file,'{magic}'=>$magic)));
+
+		if(($revision=$this->readInteger($fr))!=0)
+			throw new CException(Yii::t('yii','Invalid MO file revision: {revision}.',
+				array('{revision}'=>$revision)));
+
+		$count=$this->readInteger($fr);
+		$sourceOffset=$this->readInteger($fr);
+		$targetOffset=$this->readInteger($fr);
+
+		$sourceLengths=array();
+		$sourceOffsets=array();
+		fseek($fr,$sourceOffset);
+		for($i=0;$i<$count;++$i)
+		{
+			$sourceLengths[]=$this->readInteger($fr);
+			$sourceOffsets[]=$this->readInteger($fr);
+		}
+
+		$targetLengths=array();
+		$targetOffsets=array();
+		fseek($fr,$targetOffset);
+		for($i=0;$i<$count;++$i)
+		{
+			$targetLengths[]=$this->readInteger($fr);
+			$targetOffsets[]=$this->readInteger($fr);
+		}
+
+		$messages=array();
+		for($i=0;$i<$count;++$i)
+		{
+			$id=$this->readString($fr,$sourceLengths[$i],$sourceOffsets[$i]);
+			if(($pos=strpos($id,chr(4)))!==false && substr($id,0,$pos)===$context)
+			{
+				$id=substr($id,$pos+1);
+				$message=$this->readString($fr,$targetLengths[$i],$targetOffsets[$i]);
+				$messages[$id]=$message;
+			}
+		}
+
+		@flock($fr,LOCK_UN);
+		@fclose($fr);
+
+		return $messages;
+	}
+
+	/**
+	 * Saves messages to an MO file.
+	 * @param string file path
+	 * @param array message translations (message id => translated message).
+	 * Note if the message has a context, the message id must be prefixed with
+	 * the context with chr(4) as the separator.
+	 */
+	public function save($file,$messages)
+	{
+		if(!($fw=@fopen($file,'wb')))
+			throw new CException(Yii::t('yii','Unable to write file "{file}".',
+				array('{file}'=>$file)));
+
+		if(!@flock($fw,LOCK_EX))
+			throw new CException(Yii::t('yii','Unable to lock file "{file}" for writing.',
+				array('{file}'=>$file)));
+
+		// magic
+		if($this->useBigEndian)
+			$this->writeByte($fw,pack('c*', 0x95, 0x04, 0x12, 0xde));
+		else
+			$this->writeByte($fw,pack('c*', 0xde, 0x12, 0x04, 0x95));
+
+		// revision
+		$this->writeInteger($fw,0);
+
+		// message count
+		$n=count($messages);
+		$this->writeInteger($fw,$n);
+
+		// offset of source message table
+		$offset=28;
+		$this->writeInteger($fw,$offset);
+		$offset+=($n*8);
+		$this->writeInteger($fw,$offset);
+		// hashtable size, omitted
+		$this->writeInteger($fw,0);
+		$offset+=($n*8);
+		$this->writeInteger($fw,$offset);
+
+		// length and offsets for source messagess
+		foreach(array_keys($messages) as $id)
+		{
+			$len=strlen($id);
+			$this->writeInteger($fw,$len);
+			$this->writeInteger($fw,$offset);
+			$offset+=$len+1;
+		}
+
+		// length and offsets for target messagess
+		foreach($messages as $message)
+		{
+			$len=strlen($message);
+			$this->writeInteger($fw,$len);
+			$this->writeInteger($fw,$offset);
+			$offset+=$len+1;
+		}
+
+		// source messages
+		foreach(array_keys($messages) as $id)
+			$this->writeString($fw,$id);
+
+		// target messages
+		foreach($messages as $message)
+			$this->writeString($fw,$message);
+
+		@flock($fw,LOCK_UN);
+		@fclose($fw);
+	}
+
+	/**
+	 * Reads one or several bytes.
+	 * @param resource file handle
+	 * @param integer number of bytes to read
+	 * @return string bytes
+	 */
+	protected function readByte($fr,$n=1)
+	{
+		if($n>0)
+			return fread($fr,$n);
+	}
+
+	/**
+	 * Writes bytes.
+	 * @param resource file handle
+	 * @param string the data
+	 * @return integer how many bytes are written
+	 */
+	protected function writeByte($fw,$data)
+	{
+		return fwrite($fw,$data);
+	}
+
+	/**
+	 * Reads a 4-byte integer.
+	 * @param resource file handle
+	 * @return integer the result
+	 * @see useBigEndian
+	 */
+	protected function readInteger($fr)
+	{
+		return current($array=unpack($this->useBigEndian ? 'N' : 'V', $this->readByte($fr,4)));
+	}
+
+	/**
+	 * Writes a 4-byte integer.
+	 * @param resource file handle
+	 * @param integer the data
+	 * @return integer how many bytes are written
+	 */
+	protected function writeInteger($fw,$data)
+	{
+		return $this->writeByte($fw,pack($this->useBigEndian ? 'N' : 'V', (int)$data));
+	}
+
+	/**
+	 * Reads a string.
+	 * @param resource file handle
+	 * @param integer string length
+	 * @param integer offset of the string in the file. If null, it reads from the current position.
+	 * @return string the result
+	 */
+	protected function readString($fr,$length,$offset=null)
+	{
+		if($offset!==null)
+			fseek($fr,$offset);
+		return $this->readByte($fr,$length);
+	}
+
+	/**
+	 * Writes a string.
+	 * @param resource file handle
+	 * @param string the string
+	 * @return integer how many bytes are written
+	 */
+	protected function writeString($fw,$data)
+	{
+		return $this->writeByte($fw,$data."\0");
+	}
+}