Difference between revisions of "Resource searchByName"

From Catglobe Wiki
Jump to: navigation, search
(Return type)
(Arguments)
Line 17: Line 17:
 
*SearchType: is a number. It's the value of the Search type constants. Or we can aslo use the name of [[CGS_Constants_list|the Search type constants]].
 
*SearchType: is a number. It's the value of the Search type constants. Or we can aslo use the name of [[CGS_Constants_list|the Search type constants]].
 
*SearchMaxCount: is a number. It's the number of resources we want this function return. If this parameter is not used, then will return all resources that found
 
*SearchMaxCount: is a number. It's the number of resources we want this function return. If this parameter is not used, then will return all resources that found
 +
 +
The SearchType constants list:
 +
*NAME_SEARCH_TYPE_START
 +
*NAME_SEARCH_TYPE_END
 +
*NAME_SEARCH_TYPE_ANYWHERE
 +
*NAME_SEARCH_TYPE_IDENTICAL
  
 
=== <span style="color:#DF8621;">'''Return type'''</span>  ===
 
=== <span style="color:#DF8621;">'''Return type'''</span>  ===

Revision as of 06:43, 15 March 2013

Resource_searchByName


Search resources by name.

Syntax

Resource_searchByName(ResourceName, ResourceType, ResourceTemplateResourceID, SearchType, SearchMaxCount)

Arguments

  • ResourceName: is a string. It is the pattern of name of resource which user want to look up.
  • ResourceType: is a value of Resource type constants. Or we can also use the name of Resource type constants.
  • ResourceTemplateResourceID: is a number. It is the resource id of resource template ID. This value can be set 0 if don't care which template to search for.
  • SearchType: is a number. It's the value of the Search type constants. Or we can aslo use the name of the Search type constants.
  • SearchMaxCount: is a number. It's the number of resources we want this function return. If this parameter is not used, then will return all resources that found

The SearchType constants list:

  • NAME_SEARCH_TYPE_START
  • NAME_SEARCH_TYPE_END
  • NAME_SEARCH_TYPE_ANYWHERE
  • NAME_SEARCH_TYPE_IDENTICAL

Return type

An array of matched resources, which contain the information of resources that match the search pattern.

The matched resources will be represent by an array. Below is the constants list which explain the meaning of each element in this array:

  • RESOURCE_RESOURCE_ID : Rid of resource
  • RESOURCE_NAME : Name of resource
  • RESOURCE_TYPE : Type of resource
  • RESOURCE_PARENT_RESOURCE_ID : Rid of parent resource
  • RESOURCE_TEMPLATE_RESOURCE_ID : Rid of resource template

Examples

string ResourceNamePattern = "phong";
number ResourceType = 10; // or ResourceType = Resource_Type_Report;
number ResourceTempRID = 0;
number SearchType = 1;  // or SearchType = NAME_SEARCH_TYPE_ANYWHERE;

Number SearchMaxcount= 3;
array Result;

Result = Resource_searchByName(ResourceNamePattern, ResourceType, ResourceTempRID, SearchType); 
print(Result.Count);
print(Result); 

// 5 resources were found
//{{10,37257205,Phong report 2,12,37246022,34409964},{10,37257212,Phong report 1,12,37246022,34409964},{10,37272405,phong report 3,12,37246022,34409964},{10,37272427,Phong report 4,12,37246022,34409964},{10,37272501,phong,12,37272491,34409964}}

Result = Resource_searchByName(ResourceNamePattern, ResourceType, ResourceTempRID, SearchType, SearchMaxcount); 
print(Result.Count);
print(Result); 

// 3 resources were found
//{{10,37257205,Phong report 2,12,37246022,34409964},{10,37257212,Phong report 1,12,37246022,34409964},{10,37272405,phong report 3,12,37246022,34409964}}