CGettextMoFile

所有包 | 属性 | 方法

包	system.i18n.gettext
继承	class CGettextMoFile » CGettextFile » CComponent
源自	1.0
版本	$Id: CGettextMoFile.php 2798 2011-01-01 19:29:03Z qiang.xue $
源码	framework/i18n/gettext/CGettextMoFile.php

CGettextMoFile代表一个MO的Gettext信息文件。

这个类是为了适应在 PEAR 里面的 Michael Gettext_MO 类而写的。 请参考下面相关的许可证。

Copyright (c) 2004-2005, Michael Wallner . 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.

公共属性

隐藏继承属性

属性	类型	描述	定义在
useBigEndian	boolean	当读/写一个整数的时候是否使用 Big Endian。	CGettextMoFile

公共方法

隐藏继承方法

方法	描述	定义在
__call()	如果类中没有调的方法名，则调用这个方法。	CComponent
__construct()	构造函数。	CGettextMoFile
__get()	返回一个属性值、一个事件处理程序列表或一个行为名称。	CComponent
__isset()	检查一个属性是否为null。	CComponent
__set()	设置一个组件的属性值。	CComponent
__unset()	设置一个组件的属性为null。	CComponent
asa()	返回这个名字的行为对象。	CComponent
attachBehavior()	附加一个行为到组件。	CComponent
attachBehaviors()	附加一个行为列表到组件。	CComponent
attachEventHandler()	为事件附加一个事件处理程序。	CComponent
canGetProperty()	确定属性是否可读。	CComponent
canSetProperty()	确定属性是否可写。	CComponent
detachBehavior()	从组件中分离一个行为。	CComponent
detachBehaviors()	从组件中分离所有行为。	CComponent
detachEventHandler()	分离一个存在的事件处理程序。	CComponent
disableBehavior()	禁用一个附加行为。	CComponent
disableBehaviors()	禁用组件附加的所有行为。	CComponent
enableBehavior()	启用一个附加行为。	CComponent
enableBehaviors()	启用组件附加的所有行为。	CComponent
evaluateExpression()	计算一个PHP表达式，或根据组件上下文执行回调。	CComponent
getEventHandlers()	返回一个事件的附加处理程序列表。	CComponent
hasEvent()	确定一个事件是否定义。	CComponent
hasEventHandler()	检查事件是否有附加的处理程序。	CComponent
hasProperty()	确定属性是否被定义。	CComponent
load()	从MO文件加载信息。	CGettextMoFile
raiseEvent()	发起一个事件。	CComponent
save()	保存信息到MO文件。	CGettextMoFile

受保护方法

隐藏继承方法

方法	描述	定义在
readByte()	读取一个或多个字节。	CGettextMoFile
readInteger()	读取4字节整数。	CGettextMoFile
readString()	读取字符串。	CGettextMoFile
writeByte()	写入字节。	CGettextMoFile
writeInteger()	写入4字节整数。	CGettextMoFile
writeString()	写入字符串。	CGettextMoFile

属性详细

useBigEndian 属性 public boolean $useBigEndian;

当读/写一个整数的时候是否使用 Big Endian。

方法详细

__construct() 方法

public void __construct(boolean $useBigEndian=false)
$useBigEndian	boolean	当读/写一个整数的时候是否使用 Big Endian。

源码： framework/i18n/gettext/CGettextMoFile.php#56 (显示) publicfunction__construct($useBigEndian=false)
{
$this->useBigEndian=$useBigEndian;
}

构造函数。

load() 方法

public array load(string $file, string $context)
$file	string	文件路径
$context	string	信息内容
{return}	array	翻译的信息（源信息 => 翻译的信息）

源码： framework/i18n/gettext/CGettextMoFile.php#67 (显示) publicfunctionload($file,$context)
{
if(!($fr=@fopen($file,'rb')))
thrownewCException(Yii::t('yii','Unabletoreadfile"{file}".',
array('{file}'=>$file)));

if(!@flock($fr,LOCK_SH))
thrownewCException(Yii::t('yii','Unabletolockfile"{file}"forreading.',
array('{file}'=>$file)));

$magic=current($array=unpack('c',$this->readByte($fr,4)));
if($magic==-34)
$this->useBigEndian=false;
elseif($magic==-107)
$this->useBigEndian=true;
else
thrownewCException(Yii::t('yii','InvalidMOfile:{file}(magic:{magic}).',
array('{file}'=>$file,'{magic}'=>$magic)));

if(($revision=$this->readInteger($fr))!=0)
thrownewCException(Yii::t('yii','InvalidMOfilerevision:{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;
}

从MO文件加载信息。

readByte() 方法

protected string readByte(resource $fr, integer $n=1)
$fr	resource	文件句柄
$n	integer	要读取的字节数
{return}	string	字节

源码： framework/i18n/gettext/CGettextMoFile.php#206 (显示) protectedfunctionreadByte($fr,$n=1)
{
if($n>0)
returnfread($fr,$n);
}

读取一个或多个字节。

readInteger() 方法

protected integer readInteger(resource $fr)
$fr	resource	文件句柄
{return}	integer	返回结果

源码： framework/i18n/gettext/CGettextMoFile.php#229 (显示) protectedfunctionreadInteger($fr)
{
returncurrent($array=unpack($this->useBigEndian?'N':'V',$this->readByte($fr,4)));
}

读取4字节整数。

参见

• useBigEndian

readString() 方法

protected string readString(resource $fr, integer $length, integer $offset=NULL)
$fr	resource	文件句柄
$length	integer	字符串长度
$offset	integer	字符串在文件中的偏移值，如果为null则是当前位置。
{return}	string	返回结果

源码： framework/i18n/gettext/CGettextMoFile.php#252 (显示) protectedfunctionreadString($fr,$length,$offset=null)
{
if($offset!==null)
fseek($fr,$offset);
return$this->readByte($fr,$length);
}

读取字符串。

save() 方法

public void save(string $file, array $messages)
$file	string	文件路径
$messages	array	翻译的信息（信息ID => 翻译的信息）。 注意： 如果信息有上下文，信息ID一定要用上下文的 chr(4) 前缀作为分隔符。

源码： framework/i18n/gettext/CGettextMoFile.php#137 (显示) publicfunctionsave($file,$messages)
{
if(!($fw=@fopen($file,'wb')))
thrownewCException(Yii::t('yii','Unabletowritefile"{file}".',
array('{file}'=>$file)));

if(!@flock($fw,LOCK_EX))
thrownewCException(Yii::t('yii','Unabletolockfile"{file}"forwriting.',
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);

//messagecount
$n=count($messages);
$this->writeInteger($fw,$n);

//offsetofsourcemessagetable
$offset=28;
$this->writeInteger($fw,$offset);
$offset+=($n*8);
$this->writeInteger($fw,$offset);
//hashtablesize,omitted
$this->writeInteger($fw,0);
$offset+=($n*8);
$this->writeInteger($fw,$offset);

//lengthandoffsetsforsourcemessagess
foreach(array_keys($messages)as$id)
{
$len=strlen($id);
$this->writeInteger($fw,$len);
$this->writeInteger($fw,$offset);
$offset+=$len+1;
}

//lengthandoffsetsfortargetmessagess
foreach($messagesas$message)
{
$len=strlen($message);
$this->writeInteger($fw,$len);
$this->writeInteger($fw,$offset);
$offset+=$len+1;
}

//sourcemessages
foreach(array_keys($messages)as$id)
$this->writeString($fw,$id);

//targetmessages
foreach($messagesas$message)
$this->writeString($fw,$message);

@flock($fw,LOCK_UN);
@fclose($fw);
}

保存信息到MO文件。

writeByte() 方法

protected integer writeByte(resource $fw, string $data)
$fw	resource	文件句柄
$data	string	数据
{return}	integer	返回写入的字节数

源码： framework/i18n/gettext/CGettextMoFile.php#218 (显示) protectedfunctionwriteByte($fw,$data)
{
returnfwrite($fw,$data);
}

写入字节。

writeInteger() 方法

protected integer writeInteger(resource $fw, integer $data)
$fw	resource	文件句柄
$data	integer	数据
{return}	integer	返回写入的字节数

源码： framework/i18n/gettext/CGettextMoFile.php#240 (显示) protectedfunctionwriteInteger($fw,$data)
{
return$this->writeByte($fw,pack($this->useBigEndian?'N':'V',(int)$data));
}

写入4字节整数。

writeString() 方法

protected integer writeString(resource $fw, string $data)
$fw	resource	文件句柄
$data	string	字符串
{return}	integer	返回写入的字节数

源码： framework/i18n/gettext/CGettextMoFile.php#265 (显示) protectedfunctionwriteString($fw,$data)
{
return$this->writeByte($fw,$data."");
}

写入字符串。