deleteGroupWhenEmpty: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Created page with "{{Command|= Comments ____________________________________________________________________________________________ | arma3dev |= Game name |1.67|= Game version |arg= global|...")
 
m (Some wiki formatting)
 
(73 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma3dev |= Game name
|game1= arma3
|version1= 1.68


|1.67|= Game version
|arg= local


|arg= global|=
|eff= global
|eff= global |= Effects in MP
____________________________________________________________________________________________


| Marks given group for auto-deletion when group is empty. [[true]] will mark the group for auto-deletion, however [[false]] will only unmark the group that was marked previously. There are other engine group auto-deletion mechanisms in place, which are not affected by this.<br><br>
|gr1= Groups
'''NOTE:''' It might take up to a minute for the groups marked for auto-deletion when empty to get deleted when they become empty.|=
____________________________________________________________________________________________


| group '''deleteGroupWhenEmpty''' delete |= Syntax
|descr= Marks given group for auto-deletion when group is empty.
[[true]] will mark the group for auto-deletion once empty, [[false]] will simply unmark the group that was marked previously.
{{Feature|important|This command does '''not''' prevent group deletion (through e.g [[deleteGroup]] or any engine group management).}}


|p1= group: [[Group]] |= Parameter 1
|s1= group [[deleteGroupWhenEmpty]] delete
|p2= delete: [[Boolean]] - [[true]] to mark for auto-deletion|= Parameter 1


| [[Nothing]] |= Return value
|p1= group: [[Group]]


____________________________________________________________________________________________
|p2= delete: [[Boolean]] - [[true]] to mark for auto-deletion on empty group, [[false]] to not use this auto-deletion system
 
|x1= <code>_group [[deleteGroupWhenEmpty]] [[true]];</code> |= Example 1
____________________________________________________________________________________________


| [[deleteGroup]], [[isGroupDeletedWhenEmpty]], [[createGroup]], [[group]], [[setGroupId]], [[groupID]], [[units]], [[groupFromNetId]], [[netId]], [[leader]], [[selectLeader]], [[join]], [[createCenter]], [[createUnit]], [[createVehicle]], [[Side]] |= See also
|r1= [[Nothing]]


}}
|x1= <sqf>_group deleteGroupWhenEmpty true;</sqf>


<h3 style="display:none">Notes</h3>
|x2= Executed on the server:
<dl class="command_description">
<sqf>
if (local _group) then
{
_group deleteGroupWhenEmpty true;
}
else // group is local to a client
{
[_group, true] remoteExec ["deleteGroupWhenEmpty", groupOwner _group];
};
</sqf>


</dl>
|seealso= [[deleteGroup]] [[isGroupDeletedWhenEmpty]] [[createGroup]] [[group]] [[setGroupId]] [[groupID]] [[units]] [[groupFromNetId]] [[netId]] [[leader]] [[selectLeader]] [[join]] [[createCenter]] [[createUnit]] [[createVehicle]] [[Side]]
}}


<h3 style="display:none">Bottom Section</h3>
{{Note
 
|user= PierreMGI
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
|timestamp= 20231201050428
|text= The auto-deletion of a group is not automatic. For example, if you place a group in editor, name it (grp1), and kill the units in preview, this group remains not null and is counted as group (checked by count allGroups).
On the other hand, if you write: <sqf inline>this deleteGroupWhenEmpty true</sqf> in composition init (group init), this group will become null sometimes after the units are killed. It takes a little time for dead units to exit the group, then an extra time for the group to be deleted once all units dead. (count allGroups decreases).
Of course, in both cases, grp1 remains a variable ("grp1" is not nil).
}}

Latest revision as of 12:37, 12 March 2024

Arma 3 logo black.png1.68
LALocalGEGlobal
Hover & click on the images for description

Description

Description:
Marks given group for auto-deletion when group is empty. true will mark the group for auto-deletion once empty, false will simply unmark the group that was marked previously.
⚠
This command does not prevent group deletion (through e.g deleteGroup or any engine group management).
Groups:
Groups

Syntax

Syntax:
group deleteGroupWhenEmpty delete
Parameters:
group: Group
delete: Boolean - true to mark for auto-deletion on empty group, false to not use this auto-deletion system
Return Value:
Nothing

Examples

Example 1:
_group deleteGroupWhenEmpty true;
Example 2:
Executed on the server:
if (local _group) then { _group deleteGroupWhenEmpty true; } else // group is local to a client { [_group, true] remoteExec ["deleteGroupWhenEmpty", groupOwner _group]; };

Additional Information

See also:
deleteGroup isGroupDeletedWhenEmpty createGroup group setGroupId groupID units groupFromNetId netId leader selectLeader join createCenter createUnit createVehicle Side

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
PierreMGI - c
Posted on Dec 01, 2023 - 05:04 (UTC)
The auto-deletion of a group is not automatic. For example, if you place a group in editor, name it (grp1), and kill the units in preview, this group remains not null and is counted as group (checked by count allGroups). On the other hand, if you write: this deleteGroupWhenEmpty true in composition init (group init), this group will become null sometimes after the units are killed. It takes a little time for dead units to exit the group, then an extra time for the group to be deleted once all units dead. (count allGroups decreases). Of course, in both cases, grp1 remains a variable ("grp1" is not nil).
Retrieved from "https://community.bistudio.com/wiki?title=deleteGroupWhenEmpty&oldid=353027"