BIS fnc subSelect: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Generated by BIS_fnc_exportFunctionsToWiki)
 
m (Text replacement - "\| *((\[\[[a-zA-Z0-9_ :\\\-\/|()]+\]\],? ?)+) * \}\}" to "|seealso= $1 }}")
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{RV|type=function


{{Function|= Comments
| arma2
____________________________________________________________________________________________


| arma2 |= Game name
|1.00


|1.00|= Game version
|gr1= Arrays
____________________________________________________________________________________________


| <pre>
| Returns a sub-selection of the passed array.
/************************************************************
Subarray Select


Returns a sub-selection of the passed array. There are various
| [array, start, endOrLength] call [[BIS_fnc_subSelect]]
methods the sub-array can be determined.


Parameters: [array, beg, <end>]
|p1= array: [[Array]] array to select sub array from
Returns: subarray


array - Array to select sub array from.
|p2= start: [[Number]] index of array to begin sub-array. '''If negative''', index is counted from the end of array
beg - Index of array to begin sub-array. If negative, index is
counted from the end of array.
end - Optional. Index of array to end the sub-array. If ommitted,
remainder of the array will be selected. If negative, it
specifies the length of the sub-array (in absolute form).


Examples:
|p3= endOrLength: [[Number]] - index of array to end the sub-array. If ommitted, remainder of the array will be selected. '''If negative''', it specifies the length of the sub-array (in absolute form)


_array = ["a","b",true,3,8];
| [[Array]]
[_array, 2] call BIS_fnc_subSelect; //returns [true,3,8]
[_array, -2] call BIS_fnc_subSelect; //returns [3,8]
[_array, 1, 3] call BIS_fnc_subSelect; //returns ["b",true,3]
[_array, 1, -2] call BIS_fnc_subSelect; //returns ["b",true]


************************************************************/
|x1= <code>_array = ["a","b",[[true]],3,8];
[_array, 2] [[call]] [[BIS_fnc_subSelect]]; {{codecomment|// returns [true,3,8]}}</code>


</pre><small>''(Placeholder description extracted from the function header by [[BIS_fnc_exportFunctionsToWiki]])''</small> |= Description
|x2= <code>[_array, -2] [[call]] [[BIS_fnc_subSelect]]; {{codecomment|// returns [3,8]}}</code>
____________________________________________________________________________________________


| <!-- [] call [[BIS_fnc_subSelect]]; --> |= Syntax
|x3= <code>[_array, 1, 3] [[call]] [[BIS_fnc_subSelect]]; {{codecomment|// returns ["b",true,3]}}</code>


|p1= |= Parameter 1
|x4= <code>[_array, 1, -2] [[call]] [[BIS_fnc_subSelect]]; {{codecomment|// returns ["b",true]}}</code>


| |= Return value
|seealso= [[select]], [[count]], [[selectRandom]], [[BIS_fnc_arrayShuffle]], [[BIS_fnc_randomIndex]]
____________________________________________________________________________________________
}}
 
|x1= <code></code> |=
____________________________________________________________________________________________
 
| |= See also


}}


<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
</dl>


<h3 style="display:none">Bottom Section</h3>
[[Category:Function Group: Arrays|{{uc:subSelect}}]]
[[Category:Functions|{{uc:subSelect}}]]
[[Category:{{Name|arma2}}: Functions|{{uc:subSelect}}]]
[[Category:{{Name|arma2}}: Functions|{{uc:subSelect}}]]
[[Category:{{Name|arma2oa}}: Functions|{{uc:subSelect}}]]
[[Category:{{Name|arma2oa}}: Functions|{{uc:subSelect}}]]
[[Category:{{Name|tkoh}}: Functions|{{uc:subSelect}}]]
[[Category:{{Name|tkoh}}: Functions|{{uc:subSelect}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:subSelect}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:subSelect}}]]

Revision as of 01:37, 17 February 2021

Game1 needed - Version1 needed
Hover & click on the images for description

Description

Description:
This article is a Stub. You can help BI Community Wiki by expanding it.
Description needed
Execution:
call
Groups:
Arrays

Syntax

Syntax:
Syntax needed
Parameters:
array: Array array to select sub array from
start: Number index of array to begin sub-array. If negative, index is counted from the end of array
endOrLength: Number - index of array to end the sub-array. If ommitted, remainder of the array will be selected. If negative, it specifies the length of the sub-array (in absolute form)
Return Value:
Return value needed

Examples

Example 1:
_array = ["a","b",true,3,8]; [_array, 2] call BIS_fnc_subSelect; // returns [true,3,8]
Example 2:
[_array, -2] call BIS_fnc_subSelect; // returns [3,8]
Example 3:
[_array, 1, 3] call BIS_fnc_subSelect; // returns ["b",true,3]
Example 4:
[_array, 1, -2] call BIS_fnc_subSelect; // returns ["b",true]

Additional Information

See also:
selectcountselectRandomBIS_fnc_arrayShuffleBIS_fnc_randomIndex

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
Retrieved from "https://community.bistudio.com/wiki?title=BIS_fnc_subSelect&oldid=249262"