ENV_SearchByType

Syntax

#include <nitro/env.h>
ENVResource* ENV_SearchByMember(
           ENVResourceIter*  iter,
           u16               type );
  

Arguments

iter Resource iterator
type Type of resource to search for (ENV_RESTYPE_xxx)

Return Values

Returns a pointer to the resource if it was obtainable. If the pointer is unobtainable, it returns NULL.

Description

Searches for and gets the designated resource of the resource type.

Be sure to prepare a resource iterator in advance and initialize it with ENV_InitIter. By continuously searching with this iterator, you can successively get resources that match the conditions.

For more information about resource types, see the ENV_GetType function.

Example:
Following is an example of getting a resource of resource type u32.

ENVResourceIter  iter;
ENVResource*    p;

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

See Also

ENV_Init
ENV_GetType
ENV_InitIter
ENV_SearchByClass
ENV_SearchByMember
ENV_SearchByPartialName
ENV_GetLastResourceSetFromIter

Revision History

2005/08/18 Initial version.


CONFIDENTIAL