primaryWeaponMagazine: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
m (Some wiki formatting)
 
(49 intermediate revisions by 4 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 array containing class name of currently loaded primary weapon magazine (or magazine'''s''' in case of weapon having grenade launcher), otherwise it returns []. This command is used for infantry weapons only.  |= Description
|p1= unit: [[Object]]
____________________________________________________________________________


________________
|r1= [[Array]]


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


 
|x2= <sqf>
|p1= unit: [[Object]]  |PARAMETER1=
_array = primaryWeaponMagazine player;
 
if (count _array > 0) then {
| [[Array]] |RETURNVALUE=
hint ("Primary weapon is loaded with " + (_array select 0) + "!");
 
} else {
 
if (primaryWeapon player != "") then {
|x1= <code>[[hint]] [[primaryWeaponMagazine]] [[player]]; //["30Rnd_65x39_caseless_mag"]
hint "Primary weapon is not loaded!";
</code>|EXAMPLE1=
} else {
 
hint "Player doesn't have a primary weapon!";
|x2= <code>_array <nowiki>=</nowiki> [[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!";
};
};
};
};
</code>|EXAMPLE2=
</sqf>
 
____________________________________________________________________________
 
________________


| [[primaryWeapon]], [[primaryWeaponItems]], [[addPrimaryWeaponItem]], [[removePrimaryWeaponItem]], [[removeAllPrimaryWeaponItems]], [[handgunMagazine]], [[secondaryWeaponMagazine]] |SEEALSO=
|seealso= [[primaryWeapon]] [[primaryWeaponItems]] [[addPrimaryWeaponItem]] [[removePrimaryWeaponItem]] [[removeAllPrimaryWeaponItems]] [[handgunMagazine]] [[secondaryWeaponMagazine]] [[binocularMagazine]]
 
|  |MPBEHAVIOUR=
____________________________________________________________________________
 
________________
}}
}}


<h3 style='display:none'>Notes</h3>
{{Note
<dl class='command_description'>
|user= Pierre MGI
<!-- Note Section BEGIN -->
|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>
<!-- Note Section END -->
For example ["30Rnd_556x45_Stanag", "1Rnd_HE_Grenade_shell"], with no consideration about amount of these ammo.<br>
</dl>
However, be careful if you intend to use it in expression like : (magazines _unit) - (primaryWeaponMagazine _unit), i.e. magazines "minus" this array,<br>
 
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>
<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Weapons|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on June 8, 2014 - 21:52 (UTC)</dd>
<dt class="note">'''[[User:Pierre MGI|Pierre MGI]]'''</dt>
<dd class="note">
 
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/>
However, be careful if you intend to use it in expression like : (magazines _unit) - (primaryWeaponMagazine _unit), i.e. magazines "minus" this array,<br/>
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!
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!
 
}}
</dd>
</dl>
<!-- DISCONTINUE Notes -->

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!