list: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
Line 11: Line 11:
| List of units that would activate given [[Triggers|Trigger]].
| List of units that would activate given [[Triggers|Trigger]].


It returns nothing before the simulation strted, i.e. in (undelayed) init.sqf files or in VBS OME. Returns a '''[[Array#Array_references|pointer]]''' to the trigger's list after the simulation started.<br>Since this is just a ''reference'' this means that the value in your local variable will change as the content of the trigger area changes. To permanently copy the returned list to a different variable, use _mylist <nowiki>=</nowiki> +(list triggerOne).
It returns nothing before the simulation started, i.e. in (undelayed) init.sqf files. Returns a '''[[Array#Array_references|pointer]]''' to the trigger's list after the simulation started.<br>Since this is just a ''reference'' this means that the value in your local variable will change as the content of the trigger area changes. To permanently copy the returned list to a different variable, use _mylist <nowiki>=</nowiki> +(list triggerOne).


The second example can be used inside the trigger (in that case, no need to name your trigger).
The second example can be used inside the trigger (in that case, no need to name your trigger).


For trigger of type "Not present" the list is the same as that returned for "present". |= Description
The list returned for trigger of type "Not present" is the same as that returned for type "present". |= Description
____________________________________________________________________________________________
____________________________________________________________________________________________


Line 29: Line 29:
____________________________________________________________________________________________
____________________________________________________________________________________________


| |= See also
| |= See also


}}
}}

Revision as of 23:31, 12 June 2013

Hover & click on the images for description

Description

Description:
List of units that would activate given Trigger. It returns nothing before the simulation started, i.e. in (undelayed) init.sqf files. Returns a pointer to the trigger's list after the simulation started.
Since this is just a reference this means that the value in your local variable will change as the content of the trigger area changes. To permanently copy the returned list to a different variable, use _mylist = +(list triggerOne). The second example can be used inside the trigger (in that case, no need to name your trigger). The list returned for trigger of type "Not present" is the same as that returned for type "present".
Groups:
Uncategorised

Syntax

Syntax:
Array = list trigger
Parameters:
trigger: Object
Return Value:
Array or Nothing

Examples

Example 1:
_tlist = list _triggerOne;
Example 2:
hint format ["%1", thislist];

Additional Information

See also:
See also needed

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Notes

Posted on March 6, 2013 - 14:15 (CEST)
teaCup
Calling list immediately after creating a trigger via createTrigger (and setting up activation, area, statements, timeout, etc..), will return <null> instead of an array. It seems the trigger needs about 1 second to initialise, after which it will behave as expected: returning an array of all the objects inside the trigger (the ones matching the criteria), or an empty array.

Bottom Section