ENV_SearchByPartialName

構文

#include <nitro/env.h>

ENVResource* ENV_SearchByPartialName(
　　　　　　　　　　　ENVResourceIter* 　iter,
　　　　　　　　　　　const char* 　　　　partialName );
  

引数

返り値

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

説明

指定の文字列をリソース名に含むリソースを検索して取得します。

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

文字列がリソース名に含まれるかどうかの判定は、ピリオドも文字と見なし指定文字列がリソース名に含まれるかどうかで判定します。大文字小文字を区別します。

例えば リソース名に "1.test" を含むリソースを検索した場合、

"class.1.test"
"class.321.testtest"
"class.tmp.1.test.val"

はマッチしますが、

"class.1"
"class.1test"
"class.1..test"
"class.1 .test" (1の後ろにスペース)

にはマッチしません。

(例)
以下は文字列 "member" を名前に含むリソースを取得しています。

ENVResourceIter　 iter;
ENVResource* 　　　p;

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

参照

ENV_Init, ENV_InitIter
ENV_SearchByMember, ENV_SearchByType, ENV_SearchByClass
ENV_GetLastResourceSetFromIter

履歴

2005/08/23 初版