一些API文档的翻译

RFs::GetDir()
IMPORT_C TInt GetDir(const TDesC& aName,TUint anEntryAttMask,TUint anEntrySortKey,CDir*& anEntryList)const;
描述：
得到目录内容的过滤列表。
位掩码决定哪一个文件和目录的进入类型应该被列出。整理键决定列出内容的顺序。
注意：
1。如果以UID排列（当ESortByUid位“或”上整理键时表示）
，那么UID信息将被包含到列表正，不管KEntryAttAllowUid是否在anAttMask中指定。
2。如果函数设置aFileList为NULL，那么在附加条目到列表之前为其分配内存。
那么在这个函数被调用前，aFileList将没有分配内存，否则这段内存将被孤立。
3。调用者有责任在函数返回后释放aFileList的内存。
---------------------------------------------------------------------------------------------
Math::Rand()
static IMPORT_C TINt Rand(TInt64& aSeed);
描述：
在0到KMaxTInt间产生均匀分布的假随机整数流。
对于你希望产生的每一个假随机数流，你在调用此函数时，应该传入相同的64位种子，在每次调用间不要改变它。
-------------------------------------------------------------------------------------------------------
Class CDir
class CDir:public CBase;
描述：
从文件系统读入到内存中的目录条目数组。
可以被用户读取和排序，但是不能被其创建。
继承：
CBase - 堆上实例化的基类
成员：
CDir定义：
AddL(),CDir(),Compress(),Count(),ExtractL(),NewL(),Sort(),iArray,operator[](),~CDir()
继承自CBase:
Delete(),Extension_(),operator_new()
-----------------------------------------------------------------------------------------------------
RFile::Read()
IMPORT_C TInt Read(TInt aPos, TDes8& aDes) const;
描述：
从文件内指定位置开始读取。
这是同步函数。
注意：当尝试读取超过文件结尾位置时，不会返回错误。描述符长度被设为读入字节数的长度。
因此，当到达文件结尾时读取描述符的长度，如TDesC8::Length()返回的一样，是0
参数：
TInt aPos  读取第一个字节的位置。这是从文件开始位置的位移。如果不指定位置，读取开始于当前文件位置。
  如果aPos超过了文件结尾，函数返回0长度描述符。指定KCurrentPosition读取当前位置。
TDes8 &aDes 二进制数据读入的描述符。任何现有的内容被覆盖。返回时，其长度被设为读入字节数。

IMPORT_C TInt Read(TInt aPos,TDes8& aDes,TInt aLength) const;
描述：
从指定位置开始读取指定字节数。
同步函数。
如果aLength比描述符的长度要小，唯一Read()会返回较请求字符数少的情况发生在：遇到文件结尾或发生错误。
参数：
TInt aLength 从文件读到描述符的字节数。如果尝试读取笔描述符最大长度更多的字节，函数将返回KerrOverFlow。
  不能为负，否则返回KErrGeneral。
----------------------------------------------------------------------------------------------------------
TDesC16::Length()
inline TInt Length() const;
描述：
得到数据长度。
这是描述符表示的16位数据项的长度。
-------------------------------------------------------------------------------------
HBufC16::NewL()
static IMPORT_C HBufC16* NewL(TInt aMaxLength);
描述：
创建和返回一个新的16位堆描述符的指针，失败时抛异常。
这个堆描述符是空的，其长度为0。
接下来，数据能够使用赋值操作符指定。
参数：
TInt aMaxLength  需要的描述符的最大长度。注意结果堆单元尺寸，结果描述符最大长度可以大于要求的。
---------------------------------------------------------------------------------------------------
TDes16::Copy()
IMPORT_C void Copy(const TDesC8 &aDes);
描述：
拷贝数据到此描述符，途欢任何现存数据。
这个描述符的长度依照新数据而设置。
错误码：
User 11 如果aDes的长度超过此描述符的最大长度。
----------------------------------------------------------------------------------------
RFile::Size()
IMPORT_C TInt Size(TInt &aSize) const;
描述：
得到当前文件尺寸。
参数：
TInt &aSize 以字节为单位返回尺寸。