Find_Property

Category: Objects / Search
Since engine version: 7.0 OC (extended in 9.0 OC)

Description

Search criterion: Finds all objects which have the property set to a value that converts to boolean true or equals the given value.

Syntax

array Find_Property(string property, any value);

Parameters

property:
Name of the property to check
value:
[opt] Value the property should match

Remarks

Due to C4Script limitations, it is not possible to search for value nil with this function.
For additional information on the use of this function see FindObjects.

Examples

FindObjects(Find_Distance(20), Find_Property("Collectible"))
Returns all nearby collectible objects.
FindObjects(Find_Property("Visibility", VIS_None))
Returns all invisible objects. Note that Visibility is a bitmap, but Find_Property compares the whole value.
See also: FindObjects
Sven2, 2015-08
Luchs, 2018-04