resize: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|= Game version" to "|Game version=")
mNo edit summary
 
(43 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|RESIZE]]
{{RV|type=command
[[Category:Scripting Commands OFP 1.96|RESIZE]]
[[Category:Scripting Commands ArmA|RESIZE]]


{{Command|Comments=
|game1= ofp
____________________________________________________________________________________________
|version1= 1.75


| ofpr |= Game name
|game2= ofpe
|version2= 1.00


|1.75|Game version=
|game3= arma1
____________________________________________________________________________________________
|version3= 1.00


| Changes the size of the given array. The command does not return new array, it resizes the source array to the desired number of elements. If the new size is bigger than the current size, the new places are filled with [[nil]]s. |DESCRIPTION=
|game4= arma2
____________________________________________________________________________________________
|version4= 1.00


| array '''resize''' count |SYNTAX=
|game5= arma2oa
|version5= 1.50


|p1= array: [[Array]] |PARAMETER1=
|game6= tkoh
|p2= count: [[Number]] - the new number of elements. |PARAMETER2=
|version6= 1.00


| [[Nothing]] |RETURNVALUE=
|game7= arma3
____________________________________________________________________________________________
|version7= 0.50
 
|x1= <code>_arrayNum = [0,1,2,3,4];
_arrayNum [[resize]] 2; // _arrayNum is now [0,1]
</code>|EXAMPLE1=
____________________________________________________________________________________________


| [[Array]], [[set]], [[reverse]], [[select]], [[in]], [[find]], [[findIf]], [[toArray]], [[toString]], [[forEach]], [[count]], [[pushBack]], [[pushBackUnique]], [[apply]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]]|SEEALSO=
|gr1= Arrays


}}
|descr= Changes the size of the given array. The command does not return new array, it resizes the source array to the desired number of elements.
If the new size is bigger than the current size, the new places are filled with [[nil]]. The {{Link|#Syntax 2|alternative syntax}} allows to fill resized positions with a given value. [[Array]] and [[HashMap]] values are copied.
 
|s1= array [[resize]] count
 
|p1= array: [[Array]] of [[Anything]]
 
|p2= count: [[Number]] - the new array size
 
|r1= [[Nothing]]
 
|s2= array [[resize]] [count, fill]
|s2since= arma3 2.10
 
|p21= array: [[Array]] of [[Anything]]
 
|p22= count: [[Number]] - the new array size
|p23= fill: [[Anything]] - value to fill added positions
 
|r2= [[Nothing]]
 
 
|x1= <sqf>
_arrayNum = [0,1,2,3,4];
_arrayNum resize 2; // _arrayNum is now [0, 1]
_arrayNum resize 5; // _arrayNum is now [0, 1, nil, nil, nil]
</sqf>
 
|x2= <sqf>
private _array = [0, 1, 2];
_array resize [5, -1]; // _array is now [0, 1, 2, -1, -1]


<h3 style="display:none">Notes</h3>
private _array = [0, 1, 2];
<dl class="command_description">
_array resize [1, -1]; // _array is now [0]
<!-- Note Section BEGIN -->


<!-- Note Section END -->
private _array = [0, 1, 2];
</dl>
_array resize [4, "something"]; // _array is now [0, 1, 2, "something"]
</sqf>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[set]] [[reverse]] [[deleteAt]] [[deleteRange]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Variables|{{uc:{{PAGENAME}}}}]]


<!-- CONTINUE Notes -->
{{Note
<dl class="command_description">
|user= DreadedEntity
<dd class="notedate">Posted on November 13, 2014 - 06:26 (UTC)</dd>
|timestamp= 20141113062600
<dt class="note">[[User:DreadedEntity|DreadedEntity]]</dt>
|text= Use this number to resize the array to the number of elements desired, not the desired index of the final element.<br>
<dd class="note">
Use this number to resize the array to the number of elements desired, not the desired index of the final element.<br>
[[resize]] cannot be used to create a new array.
[[resize]] cannot be used to create a new array.
</dd>
}}
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 14:16, 15 June 2024

Hover & click on the images for description

Description

Description:
Changes the size of the given array. The command does not return new array, it resizes the source array to the desired number of elements. If the new size is bigger than the current size, the new places are filled with nil. The alternative syntax allows to fill resized positions with a given value. Array and HashMap values are copied.
Groups:
Arrays

Syntax

Syntax:
array resize count
Parameters:
array: Array of Anything
count: Number - the new array size
Return Value:
Nothing

Alternative Syntax

Syntax:
array resize [count, fill]
Parameters:
array: Array of Anything
count: Number - the new array size
fill: Anything - value to fill added positions
Return Value:
Nothing

Examples

Example 1:
_arrayNum = [0,1,2,3,4]; _arrayNum resize 2; // _arrayNum is now [0, 1] _arrayNum resize 5; // _arrayNum is now [0, 1, nil, nil, nil]
Example 2:
private _array = [0, 1, 2]; _array resize [5, -1]; // _array is now [0, 1, 2, -1, -1] private _array = [0, 1, 2]; _array resize [1, -1]; // _array is now [0] private _array = [0, 1, 2]; _array resize [4, "something"]; // _array is now [0, 1, 2, "something"]

Additional Information

See also:
set reverse deleteAt deleteRange

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
DreadedEntity - c
Posted on Nov 13, 2014 - 06:26 (UTC)
Use this number to resize the array to the number of elements desired, not the desired index of the final element.
resize cannot be used to create a new array.