primaryWeaponMagazine: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Created page with "{{Command|= Comments ____________________________________________________________________________ ________________ | arma3 |= Game name |0.70|= Game version __________________...")
 
m (Some wiki formatting)
 
(55 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________


________________
|game1= arma3
|version1= 0.70


| arma3 |= Game name
|gr1= Unit Inventory


|0.70|= Game version
|descr= Collects all loaded [[magazines]] from all [[primaryWeapon]] muzzles and returns them in [[Array]], otherwise it returns []. This command is used for infantry weapons only.
____________________________________________________________________________


________________
|s1= [[primaryWeaponMagazine]] unit


| Returns class names of currently loaded magazines in given weapon.  |=  
|p1= unit: [[Object]]


Description
|r1= [[Array]]
____________________________________________________________________________


________________
|x1= <sqf>hint str primaryWeaponMagazine player; //["30Rnd_65x39_caseless_mag"]</sqf>


| '''primaryWeaponMagazine''' vehicle |= Syntax
|x2= <sqf>
_array = primaryWeaponMagazine player;
if (count _array > 0) then {
hint ("Primary weapon is loaded with " + (_array select 0) + "!");
} else {
if (primaryWeapon player != "") then {
hint "Primary weapon is not loaded!";
} else {
hint "Player doesn't have a primary weapon!";
};
};
</sqf>


|seealso= [[primaryWeapon]] [[primaryWeaponItems]] [[addPrimaryWeaponItem]] [[removePrimaryWeaponItem]] [[removeAllPrimaryWeaponItems]] [[handgunMagazine]] [[secondaryWeaponMagazine]] [[binocularMagazine]]
}}


|p1= vehicle: [[Object]]  |= PARAMETER1
{{Note
 
|user= Pierre MGI
| [[Array]] |= RETURNVALUE
|timestamp= 20140608215200
 
|text= This function returns an array like ["type of magazine loaded in primary weapon", "type of grenade loaded in launcher if exist"] <br>
 
For example ["30Rnd_556x45_Stanag", "1Rnd_HE_Grenade_shell"], with no consideration about amount of these ammo.<br>
|x1= <code>
However, be careful if you intend to use it in expression like : (magazines _unit) - (primaryWeaponMagazine _unit), i.e. magazines "minus" this array,<br>
</code>|= EXAMPLE1
The result will inventory all magazines (with grenades, chemlights...) except ALL magazines (and grenades eventually) belonging to the TYPE of the loaded one! i.e. you suppress ALL "30Rnd_556x45_Stanag" but the "30Rnd_556x45_Stanag_Tracer_Green" are still remaining.<br>
 
If you kill the unit, the same expression will return a consistent inventory as primary weapon "disappears" and primaryWeaponMagazine is empty. "30Rnd_556x45_Stanag" are back!
____________________________________________________________________________
 
________________
 
|  |= SEEALSO
 
|  |= MPBEHAVIOUR
____________________________________________________________________________
 
________________
}}
}}
<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:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 12:11, 13 May 2022

Hover & click on the images for description

Description

Description:
Collects all loaded magazines from all primaryWeapon muzzles and returns them in Array, otherwise it returns []. This command is used for infantry weapons only.
Groups:
Unit Inventory

Syntax

Syntax:
primaryWeaponMagazine unit
Parameters:
unit: Object
Return Value:
Array

Examples

Example 1:
hint str primaryWeaponMagazine player; //["30Rnd_65x39_caseless_mag"]
Example 2:
_array = primaryWeaponMagazine player; if (count _array > 0) then { hint ("Primary weapon is loaded with " + (_array select 0) + "!"); } else { if (primaryWeapon player != "") then { hint "Primary weapon is not loaded!"; } else { hint "Player doesn't have a primary weapon!"; }; };

Additional Information

See also:
primaryWeapon primaryWeaponItems addPrimaryWeaponItem removePrimaryWeaponItem removeAllPrimaryWeaponItems handgunMagazine secondaryWeaponMagazine binocularMagazine

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
Pierre MGI - c
Posted on Jun 08, 2014 - 21:52 (UTC)
This function returns an array like ["type of magazine loaded in primary weapon", "type of grenade loaded in launcher if exist"]
For example ["30Rnd_556x45_Stanag", "1Rnd_HE_Grenade_shell"], with no consideration about amount of these ammo.
However, be careful if you intend to use it in expression like : (magazines _unit) - (primaryWeaponMagazine _unit), i.e. magazines "minus" this array,
The result will inventory all magazines (with grenades, chemlights...) except ALL magazines (and grenades eventually) belonging to the TYPE of the loaded one! i.e. you suppress ALL "30Rnd_556x45_Stanag" but the "30Rnd_556x45_Stanag_Tracer_Green" are still remaining.
If you kill the unit, the same expression will return a consistent inventory as primary weapon "disappears" and primaryWeaponMagazine is empty. "30Rnd_556x45_Stanag" are back!