TCL_SearchPicturePathByIndex

定義

#include <twl/tcl.h>

TCLResult TCL_SearchPicturePathByIndex( const TCLAccessor* pAccessor ,
                                        char* path ,
                                        size_t len ,
                                        const TCLSearchObject* pSearchObj ,
                                        int index );
	

引数

pAccessor	アクセサ
path	パス格納バッファ
len	パス長
pSearchObj	検索オブジェクト
index	条件に合致した中で実際に取得する写真情報のインデクス

返り値

処理結果

説明

検索オブジェクトで表される検索条件に全て合致する写真情報の中から index で表される順番の写真の格納されているパスを取得します。

返り値が TCL_RESULT_SUCCESS 以外の場合は取得されるパスの値は不定です。

検索処理中に TCL_EncodeAndWritePicture や TCL_SortTable 、TCL_DeletePicture など、管理される写真の枚数の増減や順番変更が発生するような処理を行った場合の挙動は不定です。

アクセサは TCL_LoadTable や TCL_CreateTable などで初期化されている必要があります。

参照

TCL_InitSearchObject

履歴

2009/03/23 動作が不定となる条件を追加
2009/03/04 誤記修正
2008/10/07 初版