pushBackUnique: Difference between revisions

From Bohemia Interactive Community
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. |= 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. |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


| array '''pushBackUnique''' element|= Syntax
| array '''pushBackUnique''' element|SYNTAX=


|p1= array: [[Array]] |= Parameter 1
|p1= array: [[Array]] |PARAMETER1=


|p2= element: [[Anything]] |= Parameter 2
|p2= element: [[Anything]] |PARAMETER2=


| [[Number]] - index of inserted element or -1|= Return value
| [[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> |= Example 1    
[[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> |= Example 2
[[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]] |= See also
| [[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

Hover & click on the images for description

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".