#include <twl/tcl.h>
TCLResult TCL_SearchNextPicturePath( const TCLAccessor* pAccessor ,
char* path ,
size_t len ,
TCLSearchObject* pSearchObj );
| pAccessor | アクセサ |
| path | パス格納バッファ |
| len | パス長 |
| pSearchObj | 検索オブジェクト |
検索オブジェクトで表される検索条件に全て合致する写真の格納されているパスを、この関数の呼出し毎に順次取得します。
最後まで検索を行い次の写真が見つからなかった場合 TCL_RESULT_ERROR_NO_FIND_PICTURE が返ってきます。
返り値が TCL_RESULT_SUCCESS 以外の場合は取得されるパスの値は不定です。
検索処理中に TCL_EncodeAndWritePicture や TCL_SortTable 、TCL_DeletePicture など、管理される写真の枚数の増減や順番変更が発生するような処理を行った場合の挙動は不定です。
アクセサは TCL_LoadTable や TCL_CreateTable などで初期化されている必要があります。
2009/03/23 動作が不定となる条件を追加
2009/03/04 誤記修正
2008/10/07 初版