SKYENGINE API  参考手册返回目录  

 

MR_SEARCH_HANDLE mr_findStart(const char* name, char* buffer, uint32 len)



Description
开始目录搜索。
Parameters

Name Description
name 目录名
buffer 缓冲区,用于存放查找成功时第一个文件名或一级子目录名,GB编码
len 缓冲区大小

Return Value

>0                         返回的文件查找句柄
MR_FAILED              失败

Remarks

准备搜索name指定的目录,当dsm调用该函数后,系统初始化一个目录搜索,并返回第一个目录搜索的结果,每当dsm调用一次mr_findGetNext函数,系统返回下一个该目录下的文件或一级子目录名。该函数只返回查找句柄。当name为空字符串""时(注意name指向空串,但name不是NULL),搜索SkyEngine引擎的文件根目录。如:若手机以"/dsmdata/"作为SkyEngine引擎的文件根目录,当name为空字符串时,搜索目录"/dsmdata"。
例:一个目录下有文件:“a.bmp”、”b.mrp”和目录“data”,则mr_findStart返回查找句柄和“a.bmp”,紧接着的三次调用mr_findGetNext返回“b.mrp”、“data”和MR_FAILED。

Example

/*mrp code*/

char buffer[60] = { 0 };
mrc_findStart( "testDir", buffer, sizeof(buffer) );

See Also

mr_findGetNext
mr_findStop


Copyright ?2005-20010 SKY-MOBI

返回目录