pushBackUnique: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - " \|p[0-9]{1,2}=([^ ]+) + \| *(\[\[Numb.+) * " to " |p$1=$2 |r1=$3 ") |
Lou Montana (talk | contribs) m (Text replacement - "<sqf>([^↵][^<]*↵[^<]*)<\/sqf>" to "<sqf> $1 </sqf>") |
||
| (24 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{RV|type=command | {{RV|type=command | ||
|arma3 | |game1= arma3 | ||
|version1= 1.56 | |||
|1.56 | |||
|gr1= Arrays | |gr1= Arrays | ||
| 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. | |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| | {{Feature|informative|Adding string elements is '''case sensitive'''.}} | ||
|s1= | |s1= array [[pushBackUnique]] element | ||
|p1= array: [[Array]] | |p1= array: [[Array]] | ||
| | |p2= element: [[Anything]] | ||
|r1= | |r1= [[Number]] - index of inserted element or -1 | ||
|x1= < | |x1= <sqf> | ||
_index = _arr | _arr = [1,2,3]; | ||
_index = _arr pushBackUnique 3; | |||
|x2= < | hint str [_index, _arr]; // [-1,[1,2,3]] | ||
_index = _arr | </sqf> | ||
|x2= <sqf> | |||
_arr = [1,2,3]; | |||
_index = _arr pushBackUnique 4; | |||
hint str [_index, _arr]; // [3,[1,2,3,4]] | |||
</sqf> | |||
|seealso= [[pushBack]] | |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