name: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (removed game 2 editor category)
No edit summary
 
(76 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
|game1= ofp
|version1= 1.00


|1.00|= Game version
|game2= ofpe
____________________________________________________________________________________________
|version2= 1.00


| When argument is [[Object]], the command returns the name given to a unit using the [[setIdentity]] instruction or selected randomly by the game engine if [[setIdentity]] has not been used on the unit. If used on vehicle, name of first crew member (in order commander, driver, gunner). If used on an object, "Error: No unit" is being returned.<br>
|game3= arma1
When argument is [[Location]], the location's name is returned. To return the textual value of a location use [[text]] command instead.
|version3= 1.00


<br><br>'''NOTE:''' In Arma 3 [[setName]] can be used on a person to set [[name]]. However in multiplayer [[name]] always returns [[profileName]]. |= Description
|game4= arma2
____________________________________________________________________________________________
|version4= 1.00


| '''name''' object |= Syntax
|game5= arma2oa
|version5= 1.50


|p1= object: [[Object]]|= Parameter 1
|game6= tkoh
|version6= 1.00


| [[String]] |= Return value
|game7= arma3
|version7= 0.50


| s2= '''name''' location |= Syntax
|gr1= Unit Identity


|p21= location: [[Location]] |= Parameter 1
|gr2= Locations


| r2= [[String]] |= Return value
|descr= When argument is [[Object]], the command returns the name given to a unit using the [[setIdentity]] instruction or selected randomly by the game engine if [[setIdentity]] has not been used on the unit.
____________________________________________________________________________________________
If used on vehicle, name of first crew member (in order commander, driver, gunner). If used on an object, "Error: No unit" is being returned.
 
|x1= <code>_name = [[name]] [[player]];</code> |= Example 1
|x2= <code>_locationName = [[name]] myLocation;</code> |= Example 2
|x3= <code>[[name]] [[nearestLocation]] <nowiki>[</nowiki>[[position]] [[player]], "Hill"]; //""
[[text]] [[nearestLocation]] <nowiki>[</nowiki>[[position]] [[player]], "Hill"]; //"Lesnoy Khrebet"</code> |= Example 3
____________________________________________________________________________________________


| [[profileName]], [[setName]], [[nameSound]], [[setNameSound]], [[createLocation]], [[deleteLocation]], [[drawLocation]], [[locationPosition]], [[locationNull]], [[nearestLocation]], [[nearestLocations]], [[nearestLocationWithDubbing]]|= See also
|mp=  [[name]] returns [[profileName]], eventually suffixed by the server in the event of identical names, e.g {{hl|username}}/{{hl|username (2)}}.


}}
|pr= {{Feature|important|If the provided unit is dead and has been removed from its group, its identity has then been purged to save memory and using [[name]] on it will result in a logged error.}}
 
|s1= [[name]] object
 
|p1= object: [[Object]]
 
|r1= [[String]]
 
|s2= [[name]] location
 
|s2since= arma1 1.08
 
|p21= location: [[Location]]
 
|r2= [[String]] - the location's ''name''. To get its textual value, use [[text]] (see {{Link|#Example 3}})
 
|s3= [[name]] namespace
|s3since= arma3 2.18


<h3 style="display:none">Notes</h3>
|p41= namespace: [[Namespace]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<dt class="note">'''[[User:kju|kju]]'''
|r3= [[String]] - namespace's ''name''. Possible values:
<dd class="note">[[Location]] variant appears to be only for the 3d editor.


<!-- Note Section END -->
* "mission" - for [[missionNamespace]]
</dl>
* "profile" - for [[profileNamespace]]
<dl class="command_description">
* "ui" - for [[uiNamespace]]
<!-- Note Section BEGIN -->
* "parsing" - for [[parsingNamespace]]
* "local" - for [[localNamespace]]
* "missionprofile" - for [[missionProfileNamespace]]
* "server" - for [[serverNamespace]]
* "" - for some unnamed namespaces like temporary or server config for example.
* "null" - null namespace (this should never happen)


<dd class="notedate">Posted on August 4, 2006 - 10:56
|x1= <sqf>_name = name player;</sqf>
<dt class="note">'''[[User:Hardrock|hardrock]]'''<dd class="note">''Notes from before the conversion:''


Name will return an error for units that have been dead for more than a few seconds.
|x2= <sqf>_locationName = name myLocation;</sqf>


<dd class="notedate">Posted on December 15, 2006 - 05:27
|x3= <sqf>
<dt class="note">'''[[User:Kronzky|Kronzky]]'''<dd class="note">To return the name of the unit that was given in the editor's "name" field, call up the unit's object in a format statement:
name nearestLocation [position player, "Hill"]; // ""
hint format["Unit's name: %1",_unitobject]
text nearestLocation [position player, "Hill"]; // "Lesnoy Khrebet"
</sqf>


<dd class="notedate">Posted on April 14, 2009
|x4= <sqf>_currentNamespace = name currentNamespace;</sqf>
<dt class="note">'''[[User:Alef|alef]]'''
<dd class="note">Will return
Error: No vehicle
for JIP players in init.sqf, if no [[sleep]] were performed
<!-- Note Section END -->
</dl>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[profileName]] [[setName]] [[setIdentity]] [[nameSound]] [[setNameSound]] [[createLocation]] [[deleteLocation]] [[locationPosition]] [[nearestLocation]] [[nearestLocations]] [[nearestLocationWithDubbing]]
}}


{{Note
|user= Kju
|timestamp= 20170130194200
|text= [[Location]] variant appears to be only for the 3d editor.
}}


[[Category:Scripting Commands|NAME]]
{{Note
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
|user= Alef
[[Category:Scripting Commands OFP 1.96|NAME]]
|timestamp= 20090414014100
[[Category:Scripting Commands OFP 1.46|NAME]]
|text= Will return {{hl|Error: No vehicle}} for [[Multiplayer Scripting#Join In Progress|JIP]] players in [[init.sqf]], if no [[sleep]] were performed.
[[Category:Scripting Commands ArmA|NAME]]
}}
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Locations|{{uc:{{PAGENAME}}}}]]

Latest revision as of 23:20, 3 July 2024

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
When argument is Object, the command returns the name given to a unit using the setIdentity instruction or selected randomly by the game engine if setIdentity has not been used on the unit. If used on vehicle, name of first crew member (in order commander, driver, gunner). If used on an object, "Error: No unit" is being returned.
Multiplayer:
name returns profileName, eventually suffixed by the server in the event of identical names, e.g username/username (2).
Problems:
⚠
If the provided unit is dead and has been removed from its group, its identity has then been purged to save memory and using name on it will result in a logged error.
Groups:
Unit IdentityLocations

Syntax 1

Syntax:
name object
Parameters:
object: Object
Return Value:
String

Syntax 2

Syntax:
name location
Parameters:
location: Location
Return Value:
String - the location's name. To get its textual value, use text (see Example 3)

Syntax 3

Syntax:
name namespace
Parameters:
namespace: Namespace
Return Value:
String - namespace's name. Possible values:

Examples

Example 1:
_name = name player;
Example 2:
_locationName = name myLocation;
Example 3:
name nearestLocation [position player, "Hill"]; // "" text nearestLocation [position player, "Hill"]; // "Lesnoy Khrebet"
Example 4:
_currentNamespace = name currentNamespace;

Additional Information

See also:
profileName setName setIdentity nameSound setNameSound createLocation deleteLocation locationPosition nearestLocation nearestLocations nearestLocationWithDubbing

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
Kju - c
Posted on Jan 30, 2017 - 19:42 (UTC)
Location variant appears to be only for the 3d editor.
Alef - c
Posted on Apr 14, 2009 - 01:41 (UTC)
Will return Error: No vehicle for JIP players in init.sqf, if no sleep were performed.
Retrieved from "https://community.bistudio.com/wiki?title=name&oldid=364967"