isPlayer: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Added Global Argument Icon)
m (template:command argument fix)
(13 intermediate revisions by 10 users not shown)
Line 9: Line 9:
____________________________________________________________________________________________
____________________________________________________________________________________________


| Check if given person is a human player. |= Description
| Checks if given person is [[player]]. Returns [[true]] for headless clients as well.<br/><br/>
{{warning | In some cases, the identity of certain player units might fail to propagate to other clients and the server, which causes [[isPlayer]] and [[getPlayerUID]] to incorrectly return <tt>[[false]]</tt> and <tt>""</tt>, respectively, where the affected units are [[not]] [[local]].<ref>https://github.com/michail-nikolaev/task-force-arma-3-radio/issues/1096</ref> Therefore, beware of false negatives.}} |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


| '''isPlayer''' [[Object]]|= Syntax
| '''isPlayer''' person |SYNTAX=


|p1= [[Object]] |= Parameter 1
|p1= person: [[Object]] |PARAMETER1=


| [[Boolean]] |= Return value
| [[Boolean]] |RETURNVALUE=
____________________________________________________________________________________________
____________________________________________________________________________________________


|x1= <code>if (isPlayer _Soldier1) then {_Soldier1 setDamage 1;};</code> |= Example 1
|x1= <code>[[if]] ([[isPlayer]] _Soldier1) [[then]] {
    _Soldier1 [[setDamage]] 1;
};</code> |EXAMPLE1=
 
|x2= <code>_playerCount = {[[isPlayer]] _x} [[count]] [[playableUnits]];</code> |EXAMPLE2=
____________________________________________________________________________________________
____________________________________________________________________________________________
| |= See also
 
| [[player]], [[playableSlotsNumber]], [[playableUnits]], [[playersNumber]] |SEEALSO=


}}
}}
Line 28: Line 34:
<dl class="command_description">
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section BEGIN -->
This is not the same as testing object == [[player]], because in MP it tests for any player, not only for the local one. If object is a vehicle, the test is done for the vehicle commander.
 
<dd class="notedate">Posted on 1 August, 2006
<dt class="note">[[User:Kronzky|Kronzky]]
<dd class="note">This is not the same as testing object == [[player]], because in MP it tests for any player, not only for the local one. If object is a vehicle, the test is done for the vehicle commander.
 
<!-- Note Section END -->
<!-- Note Section END -->
</dl>
</dl>
Line 37: Line 47:
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Multiplayer|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Multiplayer|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Revision as of 15:41, 7 April 2019

-wrong parameter ("Arma") defined!-1.00
Hover & click on the images for description

Description

Description:
Checks if given person is player. Returns true for headless clients as well.

In some cases, the identity of certain player units might fail to propagate to other clients and the server, which causes isPlayer and getPlayerUID to incorrectly return false and "", respectively, where the affected units are not local.[1] Therefore, beware of false negatives.
Groups:
Uncategorised

Syntax

Syntax:
isPlayer person
Parameters:
person: Object
Return Value:
Boolean

Examples

Example 1:
if (isPlayer _Soldier1) then { _Soldier1 setDamage 1; };
Example 2:
_playerCount = {isPlayer _x} count playableUnits;

Additional Information

See also:
playerplayableSlotsNumberplayableUnitsplayersNumber

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

Notes

Posted on 1 August, 2006
Kronzky
This is not the same as testing object == player, because in MP it tests for any player, not only for the local one. If object is a vehicle, the test is done for the vehicle commander.

Bottom Section