ENV_SearchByMember

構文

#include <nitro/env.h>
ENVResource* ENV_SearchByMember(
           ENVResourceIter*  iter,
           const char*     memberName );
  

引数

iter リソースイテレータ
memberName 検索するメンバ名

返り値

取得できた場合はリソースへのポインタを返します。
取得できない場合は NULL を返します。

説明

指定のメンバ名を持つリソースを検索して取得します。

予めリソースイテレータを用意し、ENV_InitIter() で初期化してください。そしてそのイテレータで検索しつづけることで、条件に合致したリソースを次々と取得することが出来ます。

メンバ名は "." (ピリオド) を含みません。例えば、メンバ名「member」で検索する場合、

"class.member"
"class.member.001"
"class.member.class"

はマッチしますが、

"class.member001"
"class.member2.member"

にはマッチしません。

(例)
以下は特定のメンバ "memberName" を持つリソースを取得しています。

ENVResourceIter  iter;
ENVResource*    p;

ENV_InitIter( &iter );
while( (p = ENV_SearchByMember( &iter, "memberName" ) ) )
{
  OS_Printf( "resource = %s\n", p->name );
}

参照

ENV_Init, ENV_InitIter
ENV_SearchByClass, ENV_SearchByType, ENV_SearchByPartialName

ENV_GetLastResourceSetFromIter

履歴

2005/08/18 初版