removeMagazines: Difference between revisions

Latest revision as of 13:00, 18 May 2025

1.00

Hover & click on the images for description

Description

Description:: Removes all magazines of given type from the unit. If magazine class does not exist, nothing happens, not even .rpt message, unlike with addMagazine command.
Groups:: Unit Inventory

Syntax

Syntax:: unitName removeMagazines magazineName
Parameters:: unitName: Object
: magazineName: String
Return Value:: Nothing

Examples

Example 1:: player removeMagazines "30Rnd_556x45_Stanag";

Additional Information

See also:: removeAllMagazines addMagazine magazines removeMagazine removeWeapon removeMagazinesTurret removeMagazineTurret setVehicleAmmo

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

Pyro05x - c: Posted on Jan 27, 2007 - 03:46 (UTC)
: Though BIS did not provide a command to remove all magazines of every type, it can still be accomplished using forEach magazines. example:
{ player removeMagazine _x } forEach magazines player;
edit: removeAllMagazines player; now exists since 2.20.

@@ Line 1: / Line 1: @@
-[[Category:Scripting Commands|R]]
+{{RV|type=command
-[[Category:Scripting Commands OFP 1.97|R]]
-[[Category:Scripting Commands OFP 1.46|R]]
-[[Category:Scripting Commands ArmA|R]]
-back to [[Scripting_Reference#R|COMREF]]
+|game1= ofp
+|version1= 1.00
-<h2 style="color:#000066">''unit '''''removeMagazines ''weaponName'''''</h2>
+|game2= ofpe
+|version2= 1.00
+|game3= arma1
+|version3= 1.00
-'''Operand types:'''
+|game4= arma2
+|version4= 1.00
-'''unit:''' [[Object]]
+|game5= arma2oa
+|version5= 1.50
-'''weaponName:''' [[String]]
+|game6= tkoh
+|version6= 1.00
-'''Type of returned value:'''
+|game7= arma3
+|version7= 0.50
-[[Nothing]]
+|arg= local
+|eff= global
-'''Description:'''
+|gr1= Unit Inventory
-Remove all magazines of given type from the unit.
+|descr= Removes all magazines of given type from the unit. If magazine class does not exist, nothing happens, not even .rpt message, unlike with [[addMagazine]] command.
-'''Note:''' You may create invalid combinations with this function.
+|s1= unitName [[removeMagazines]] magazineName
-When doing so, application behaviour is undefined.
+|p1= unitName: [[Object]]
+|p2= magazineName: [[String]]
+|r1= [[Nothing]]
-'''Example:'''
+|x1= <sqf>player removeMagazines "30Rnd_556x45_Stanag";</sqf>
-[[player]] '''removeMagazines''' "M16"
+|seealso= [[removeAllMagazines]] [[addMagazine]] [[magazines]] [[removeMagazine]] [[removeWeapon]] [[removeMagazinesTurret]] [[removeMagazineTurret]] [[setVehicleAmmo]]
+}}
+{{Note
+|user= Pyro05x
+|timestamp= 20070127034600
+|text= Though BIS did not provide a command to remove '''all''' magazines of every type, it can still be accomplished using [[forEach]] [[magazines]].
+example:
+<sqf>{ player removeMagazine _x } forEach magazines player;</sqf>
+'''edit:''' <sqf inline>removeAllMagazines player;</sqf> now exists since {{GVI|arma3|2.20|size= 0.75}}.
+}}