ifilemgr 接口

首先，调用 IFILEMGR_EnumInit() 设置要搜索的条件（文件和目录） 随后每次调用 IFILEMGR_EnumNext()，得到下一个符合条件的文件 及其信息，如名称、大小、创建日期和属性。 搜索完所有指定的文件或 目录后，IFILEMGR_EnumNext() 将返回 FALSE。
IFILEMGR_GetInfo() 获取指定文件或目录的信息，也可以通 获取指定文件或目录的信息， 过调用 IFILE_GetInfo() 并输入其 IFile 实例指针来获取打开的 文件的信息。 文件的信息。 IFILEMGR_GetFreeSpace() 返回设备文件系统中可用的空闲 字节数。 字节数。 IFILEMGR_GetLastError() 返回 IFileMgr 函数最近检测到 的错误（如果有）的错误代码。 通过该错误代码可以获取函数未能 的错误（如果有）的错误代码。 执行所请求任务的具体原因。错误码定义在AEEError.h中。 执行所请求任务的具体原因。错误码定义在 中 IFILEMGR_Test() 用于检查指定文件或目录是否存在。 用于检查指定文件或目录是否存在。
BREW技术开发与应用
IFileMgr 接口的函数
IFILEMGR_MkDir() 用于创建新目录，该目录通过与调用该 用于创建新目录， 函数的小程序目录相关的名称和路径来指定。 函数的小程序目录相关的名称和路径来指定。 IFILEMGR_RmDir() 用于删除目录（首先必须删除要删除的 用于删除目录（ 目录下的所有文件和目录）。 目录下的所有文件和目录）。 IFILEMGR_OpenFile() 用于创建新文件，或打开现有的文件 用于创建新文件， 以进行读取和（ 写入。 以进行读取和（或）写入。 该文件通过它与小程序目录相关的名 称和路径指定。 称和路径指定。 IFILE_Release()，可以关闭打开的文件。 ，可以关闭打开的文件。 IFILEMGR_Rename() 用于重命名文件， 用于重命名文件， IFILEMGR_Remove() 用于删除文件。 文件必须先关闭然后 用于删除文件。 才能重命名或删除。 如果文件被多个程序打开， 才能重命名或删除。 如果文件被多个程序打开，则必须对每个打 开执行相应的关闭操作，然后才能进行重命名或删除操作。 开执行相应的关闭操作，然后才能进行重命名或删除操作。
BREW技术开发与应用
写文件
uint32 IFILE_Write ( IFile * pIFile, PACKED const void * pBuffer, uint32 dwCount ) 参数： 参数：
pIFile： [in]： 指向 IFile 接口对象的指针 pBuffer： [out]： 写入数据的缓冲区 dwCount： [in]： 要写入的字节数
返回值： 返回值：
写入的字节数： 如果成功 0（零）： 如果失败
BREW技术开发与应用
写文件举例
将‘a’, ‘b’,‘c’,‘d’四个字符写入文 ’ ’‘ ’‘ ’ 件
int j; char data[]={'a','b','c','d'}; j=IFILE_Write(pIFile,data,sizeof(data)); DBGPRINTF(" write %d bytes into file:",j); if (j==0) //错误处理 错误处理
BREW技术开发与应用
定位读写指针
uint32 IFILE_Seek ( IFile * pIFile, FileSeekType seekType, 参数： 参数： int32 moveDistance )
pIFile： 指向 IFile 接口对象 seekType： [_SEEK_CURRENT | _SEEK_START | _SEEK_END] 的指针 moveDistance： 要移动的距离
IFileMgr /IFile接Байду номын сангаас /IFile接口
文件访问接口
在BREW中，对文件操作主要有两个接口 中 IFileMgr接口和 接口和IFile接口 接口和 接口 IFileMgr 接口
接口函数用于创建、删除和重命名文件/目录， 并 提供获取文件和目录信息。
IFile接口 接口
主要提供对文件的读read、写write、定位读写指 针seek等操作。
BREW技术开发与应用
在 "fs:/" 名称空间中，以下路径具有特殊含义： 名称空间中，以下路径具有特殊含义：
“fs:/” (AEEFS_ROOT_DIR)： BREW 文件名称空间的根目 ” ： 录。 "fs:/~/" (AEEFS_HOME_DIR)： 这是表示当前在运行应用程 ： 序目录的快捷方式。 它映射到 "fs:/mod/<modid>"，其中 序目录的快捷方式。 ， <modid> 为当前在运行应用程序的模块 ID。 。 "fs:/mod/" (AEEFS_MOD_DIR)： 所有模块目录的位置。 ： 所有模块目录的位置。 "fs:/mif/" (AEEFS_MIF_DIR)： 所有 BREW MIF 文件的 ： 位置。 位置。 "fs:/shared/" (AEEFS_SHARED_DIR)： "Shared" 的新 ： 名称。 该名称可用以与其它名称区分大小写的应用程序共享文件。 名称。 该名称可用以与其它名称区分大小写的应用程序共享文件。 “fs:/address/” (AEEFS_ADDRESS_DIR)： 地址簿目录 ” ： 的位置。 的位置。 "fs:/ringers/" (AEEFS_RINGERS_DIR)： 设备振铃目录的 ： 位置。 应用程序必须有 PL_RINGER_WRITE（振铃目录的写权 位置。 （ ），才能访问此目录中的文件 才能访问此目录中的文件。 限），才能访问此目录中的文件。
返回值： 返回值：
读取的字节数： 如果成功 0（零）： 如果失败
BREW技术开发与应用
读文件举例： 读文件举例：
将文件中的数据循环读出，每次读 个字符 个字符， 将文件中的数据循环读出，每次读1个字符，直到结束 char i; while (IFILE_Read(pIFile,&i,sizeof(i))== sizeof(i)){ DBGPRINTF(" %d is read from f2!",i); } IFILE_Release(pIFile);
返回值：指向该文件的指针 返回值：指向该文件的指针IFile*
BREW技术开发与应用
举例： 举例：
创建f1文件： 创建 文件： 文件 IFile *pIFile; pIFile = IFILEMGR_OpenFile(pMe>pIFileMgr,"f1",_OFM_CREATE);
BREW技术开发与应用
BREW技术开发与应用
BREW中的文件名 BREW中的文件名
之前， 在BREW 3.0之前，文件名和目录名不区分大小写。 之前 文件名和目录名不区分大小写。 如果为 IFileMgr（或其它相关 API）指定了文件 （ ） 或目录名，文件名将全部变成小写。例如， 或目录名，文件名将全部变成小写。例如， “Foo.bar” 文件名将作为 “foo.bar” 处理。 ” ” 处理。 从BREW 3.0 开始，BREW 文件的名称空间已扩 开始， 展，允许应用程序以区分大小写的方式命名 BREW 文件系统中的任何文件和目录。 文件系统中的任何文件和目录。使文件名以 "fs:/" 文件名称空间。 开头来访问新的 BREW 文件名称空间。不以 "fs:/" 开头的文件名解释为向后兼容。 开头的文件名解释为向后兼容。
3.
接口实例， 如果不再需要 IFileMgr 接口实例，则调用 IFILEMGR_Release()释放接口实例。 释放接口实例。 释放接口实例 需要的头文件： 需要的头文件： AEEFile.h
BREW技术开发与应用
IFileMgr 接口的函数
IFILEMGR_EnumInit() 和 IFILEMGR_EnumNext() 用于 搜索指定的目录或文件
BREW技术开发与应用
访问文件的权限
IFileMgr /IFile接口 接口 要求应用程序必须具有 PL_FILE（文件）或 （文件） PL_SYSTEM（全部） （全部） 权限级别， 权限级别，才能在应用 程序的模块目录中创建 文件和目录. 文件和目录 上述权限可在MIF编辑 编辑 上述权限可在 器中设置
返回值： 返回值：
SUCCESS SUCCESS： 如果成功 ；EFAILED： 如果失败 EFAILED
备注： 备注：
指定起点 (FileSeekType) 可以有三种值： _SEEK_CURRENT _SEEK_START _SEEK_END 您可以指定正、负方向（值）的移动距离。 例如从文件末尾 (_SEEK_END) 开始定位时使用负方向。 如果定位类型为 _SEEK_CURRENT，且移动距离为 0（零），此函数可起识别作用， 返回文件指针的当前位置； 如果文件的打开模式为 _OFM_READ，并且从指定起点的移动距离在文件边界范围内， 此操作便会成功。 如果文件以 _OFM_READWRITE 模式打开，并且移动距离指向文件开始之前的位置， 此操作将失败。 如果从指定起点移动的距离超出了文件的结尾，则文件大小将从定位起点扩展到移至的 位置。 例如，假设用 READWRITE 模式创建了一个文件，文件大小为 40 字节。 如 果调用定位类型为 _SEEK_START 的 IFILE_Seek() 函数，且移动距离为 120，将 会使文件的大小增加到 120 字节，而文件指针会指向文件的末尾。 BREW技术开发与应用