list: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
Lou Montana (talk | contribs) m (Text replacement - " <!-- (DIS)?CONTINUE Notes -->" to "") |
||
(42 intermediate revisions by 11 users not shown) | |||
Line 1: | Line 1: | ||
{{ | {{RV|type=command | ||
| ofp | | ofp | ||
|1.00 | |1.00 | ||
|arg= global |= | |arg= global | ||
|eff= local |= Effect in MP | |||
|gr1= Triggers | |||
| List of units that would activate given [[Triggers|Trigger]]. | | List of units that would activate given [[Triggers|Trigger]]. | ||
It returns nothing before the simulation | 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 list returned for trigger of type "Not present" is the same as that returned for type "present". | |||
'''NOTE:''' While the command can query any trigger, local or remote, the result will be only for the trigger condition set on the local client. See [[createTrigger]] for more info. | |||
| [[Array]] or [[Nothing]] | |[[Array]] <nowiki>=</nowiki> '''list''' trigger | ||
|p1= trigger: [[Object]] | |||
| [[Array]] or [[Nothing]] | |||
|x1= <code>_tlist <nowiki>=</nowiki> '''list''' _triggerOne </code>|= | |x1= <code>_tlist <nowiki>=</nowiki> '''list''' _triggerOne; </code> | ||
|x2= <code>[[hint]] [[format]] ["%1", [[thisList]]]; </code> | |||
|seealso= [[setTriggerActivation]], [[createTrigger]], [[thisList]] | |||
}} | }} | ||
<dl class="command_description"> | <dl class="command_description"> | ||
< | <dt><dt> | ||
<dd class="notedate">Posted on March 6, 2013 - 14:15 (CEST)</dd> | |||
< | <dt class="note">[[User:TeaCup|teaCup]]</dt> | ||
<dd class="note">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. | |||
</dl> | </dl> | ||
< | |||
{{GameCategory|arma1|Scripting Commands}} | |||
[[ | {{GameCategory|arma2|Scripting Commands}} | ||
{{GameCategory|arma3|Scripting Commands}} | |||
[[ | {{GameCategory|tkoh|Scripting Commands}} | ||
<dl class="command_description"> | |||
<dt></dt> | |||
<dd class="notedate">Posted on January 6, 2021 - 01:58 (UTC)</dd> | |||
<dt class="note">[[User:7erra|7erra]]</dt> | |||
<dd class="note"> | |||
The resulting array is not modifiable. Any [[:Category:Command_Group:_Arrays|array related commands]], that modify the original array, will fail with the error message: {{ic|Error Reserved variable in expression}}. | |||
</dd> | |||
</dl> |
Revision as of 00:55, 6 April 2021
Description
- Description:
- Description needed
- Groups:
- Triggers
Syntax
- Syntax:
- Syntax needed
- Parameters:
- trigger: Object
- Return Value:
- Return value needed
Examples
Additional Information
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
- 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.
- Posted on January 6, 2021 - 01:58 (UTC)
- 7erra
-
The resulting array is not modifiable. Any array related commands, that modify the original array, will fail with the error message:
Error Reserved variable in expression
.