pushBackUnique: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - " <h3 style="display:none">Notes</h3> <dl class="command_description"> <!-- Note Section BEGIN --> <!-- Note Section END --> </dl> " to "") |
Lou Montana (talk | contribs) m (Text replacement - "<sqf>([^↵][^<]*↵[^<]*)<\/sqf>" to "<sqf> $1 </sqf>") |
||
| (34 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{ | {{RV|type=command | ||
|arma3| | |game1= arma3 | ||
|version1= 1.56 | |||
| | |gr1= Arrays | ||
| | |descr= Adds element to the back of the given array but only if it is unique to the array. The index of the added element is returned upon success, otherwise -1. This command modifies the original array. | ||
{{Feature|informative|Adding string elements is '''case sensitive'''.}} | |||
| | |s1= array [[pushBackUnique]] element | ||
| array | |p1= array: [[Array]] | ||
| | |p2= element: [[Anything]] | ||
| | |r1= [[Number]] - index of inserted element or -1 | ||
|x1= < | |x1= <sqf> | ||
_index = _arr | _arr = [1,2,3]; | ||
_index = _arr pushBackUnique 3; | |||
hint str [_index, _arr]; // [-1,[1,2,3]] | |||
</sqf> | |||
| [ | |x2= <sqf> | ||
_arr = [1,2,3]; | |||
_index = _arr pushBackUnique 4; | |||
hint str [_index, _arr]; // [3,[1,2,3,4]] | |||
</sqf> | |||
|seealso= [[pushBack]] [[select]] [[set]] [[resize]] [[reverse]] [[count]] [[find]] [[in]] [[forEach]] [[deleteAt]] [[deleteRange]] [[append]] [[sort]] [[arrayIntersect]] [[apply]] [[BIS_fnc_arrayPushStack]] [[BIS_fnc_arrayPush]] | |||
}} | }} | ||
Latest revision as of 19:42, 3 September 2024
Description
- Description:
- Adds element to the back of the given array but only if it is unique to the array. The index of the added element is returned upon success, otherwise -1. This command modifies the original array.
- Groups:
- Arrays
Syntax
- Syntax:
- array pushBackUnique element
- Parameters:
- array: Array
- element: Anything
- Return Value:
- Number - index of inserted element or -1
Examples
- Example 1:
- Example 2:
Additional Information
- See also:
- pushBack select set resize reverse count find in forEach deleteAt deleteRange append sort arrayIntersect apply BIS_fnc_arrayPushStack BIS_fnc_arrayPush
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