pushBackUnique: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
m (template:command argument fix) |
||
Line 8: | Line 8: | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| 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. |= | | 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. |DESCRIPTION= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| array '''pushBackUnique''' element|= | | array '''pushBackUnique''' element|SYNTAX= | ||
|p1= array: [[Array]] |= | |p1= array: [[Array]] |PARAMETER1= | ||
|p2= element: [[Anything]] |= | |p2= element: [[Anything]] |PARAMETER2= | ||
| [[Number]] - index of inserted element or -1|= | | [[Number]] - index of inserted element or -1|RETURNVALUE= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
|x1= <code>_arr = [1,2,3]; | |x1= <code>_arr = [1,2,3]; | ||
_index = _arr [[pushBackUnique]] 3; | _index = _arr [[pushBackUnique]] 3; | ||
[[hint]] [[str]] [_index, _arr]; //[-1,[1,2,3]]</code> |= | [[hint]] [[str]] [_index, _arr]; //[-1,[1,2,3]]</code> |EXAMPLE1= | ||
|x2= <code>_arr = [1,2,3]; | |x2= <code>_arr = [1,2,3]; | ||
_index = _arr [[pushBackUnique]] 4; | _index = _arr [[pushBackUnique]] 4; | ||
[[hint]] [[str]] [_index, _arr]; //[3,[1,2,3,4]]</code> |= | [[hint]] [[str]] [_index, _arr]; //[3,[1,2,3,4]]</code> |EXAMPLE2= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| [[pushBack]], [[select]], [[set]], [[resize]], [[reverse]], [[count]], [[find]], [[in]], [[forEach]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[arrayIntersect]], [[apply]], [[BIS_fnc_arrayPushStack]], [[BIS_fnc_arrayPush]] |= | | [[pushBack]], [[select]], [[set]], [[resize]], [[reverse]], [[count]], [[find]], [[in]], [[forEach]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[arrayIntersect]], [[apply]], [[BIS_fnc_arrayPushStack]], [[BIS_fnc_arrayPush]] |SEEALSO= | ||
}} | }} |
Revision as of 14:45, 7 April 2019
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:
- Uncategorised
Syntax
- Syntax:
- array pushBackUnique element
- Parameters:
- array: Array
- element: Anything
- Return Value:
- Number - index of inserted element or -1
Examples
- Example 1:
_arr = [1,2,3]; _index = _arr pushBackUnique 3; hint str [_index, _arr]; //[-1,[1,2,3]]
- Example 2:
_arr = [1,2,3]; _index = _arr pushBackUnique 4; hint str [_index, _arr]; //[3,[1,2,3,4]]
Additional Information
- See also:
- pushBackselectsetresizereversecountfindinforEachdeleteAtdeleteRangeappendsortarrayIntersectapplyBIS_fnc_arrayPushStackBIS_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
Notes
Bottom Section
- Posted on March 22, 2019 - 13:09 (UTC)
- .kju
- Adding string elements is case sensitive. So if the array contains "a", it will still add "A".