primaryWeaponMagazine: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Some wiki formatting)
 
(54 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 either single element array, containing class name of currently loaded in the primary weapon magazine, or an empty array if unit has no primary weapon or primary weapon is not loaded. This command is used for infantry weapons only.  |=
|p1= unit: [[Object]]


Description
|r1= [[Array]]
____________________________________________________________________________


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


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


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


________________
{{Note
 
|user= Pierre MGI
| [[primaryWeapon]], [[primaryWeaponItems]], [[addPrimaryWeaponItem]], [[removePrimaryWeaponItem]], [[removeAllPrimaryWeaponItems]], [[handgunMagazine]], [[secondaryWeaponMagazine]]  |= SEEALSO
|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>
|  |= MPBEHAVIOUR
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!
}}
}}
<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

Arma 3 logo black.png0.70
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!
Retrieved from "https://community.bistudio.com/wiki?title=primaryWeaponMagazine&oldid=321013"