# ENV_SearchByPartialName

## 構文

      #include <nitro/env.h>

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

## 引数

iter | リソースイテレータ
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 初版