Difference between revisions of "name"

From Bohemia Interactive Community
Jump to navigation Jump to search
m
 
(32 intermediate revisions by 16 users not shown)
Line 1: Line 1:
{{Command|= Comments
+
{{Command|Comments=
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| ofp |= Game name
+
| ofp |Game name=
  
|1.00|= Game version
+
|1.00|Game version=
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| Returns the name of the variable assigned to the object in the mission editor.
+
| 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>
 +
When argument is [[Location]], the location's name is returned. To return the textual value of a location use [[text]] command instead.<br><br>
 +
{{Feature arma3 | [[setName]] can be used on a person to set [[name]]. However in multiplayer [[name]] always returns [[profileName]].}}|DESCRIPTION=
 +
____________________________________________________________________________________________
 +
 
 +
| [[name]] object |SYNTAX=
 +
 
 +
|p1= object: [[Object]] |PARAMETER1=
  
If used on vehicle, name of first crew member (in order commander, driver, gunner). |= Description
+
| [[String]] |RETURNVALUE=
____________________________________________________________________________________________
 
  
| '''name''' object |= Syntax
+
|s2= [[name]] location |Alternative syntax=
  
|p1= object: [[Object]] |= Parameter 1
+
|p21= location: [[Location]] |PARAMETER2=
  
| [[String]] |= Return value
+
|r2= [[String]] |RETURNVALUE2=
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
 
   
 
   
|x1= <code>_name <nowiki>=</nowiki> '''name''' [[vehicle]] [[player]]</code> |= Example 1
+
|x1= <code>_name = [[name]] [[player]];</code> |EXAMPLE1=
 +
 
 +
|x2= <code>_locationName = [[name]] myLocation;</code> |EXAMPLE2=
 +
 
 +
|x3= <code>[[name]] [[nearestLocation]] <nowiki>[</nowiki>[[position]] [[player]], "Hill"]; {{cc|""}}
 +
[[text]] [[nearestLocation]] <nowiki>[</nowiki>[[position]] [[player]], "Hill"]; {{cc|"Lesnoy Khrebet"}}</code> |EXAMPLE3=
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| |= See also
+
| [[profileName]], [[setName]], [[nameSound]], [[setNameSound]], [[createLocation]], [[deleteLocation]], [[drawLocation]], [[locationPosition]], [[locationNull]], [[nearestLocation]], [[nearestLocations]], [[nearestLocationWithDubbing]]|SEEALSO=
 
 
 
}}
 
}}
  
Line 30: Line 40:
 
<!-- Note Section BEGIN -->
 
<!-- Note Section BEGIN -->
  
<dd class="notedate">Posted on August 4, 2006 - 10:56</dd>
+
<dt class="note">[[User:kju|kju]]
<dt class="note">'''[[User:Hardrock|hardrock]]'''</dt><dd class="note">''Notes from before the conversion:''
+
<dd class="note">[[Location]] variant appears to be only for the 3d editor.
 +
 
 +
<!-- Note Section END -->
 +
</dl>
 +
<dl class="command_description">
 +
<!-- Note Section BEGIN -->
 +
 
 +
<dd class="notedate">Posted on August 4, 2006 - 10:56
 +
<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.
 
Name will return an error for units that have been dead for more than a few seconds.
</dd>
+
 
<dd class="notedate">Posted on December 15, 2006 - 05:27</dd>
+
<dd class="notedate">Posted on December 15, 2006 - 05:27
<dt class="note">'''[[User:Kronzky|Kronzky]]'''</dt><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 with a format statement: <br>
+
<dt class="note">[[User:Kronzky|Kronzky]]
'''Example:'''<br>
+
<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:  
In the editor, create the following:
+
<code>[[hint]] [[format]] ["Unit's name: %1", _unitobject];</code>
*an empty vehicle named "car1"
+
 
*a unit named "jack", with this init line: "this moveInDriver car1"
+
<dd class="notedate">Posted on April 14, 2009
*a radio trigger with this activation line: "hint format["%1",driver car1]"
+
<dt class="note">[[User:Alef|alef]]
Calling the trigger will then return the name the unit: "jack"</dd>
+
<dd class="note">Will return <tt>Error: No vehicle</tt> for [[JIP]] players in [[init.sqf]], if no [[sleep]] were performed
 
<!-- Note Section END -->
 
<!-- Note Section END -->
 
</dl>
 
</dl>
Line 49: Line 68:
  
  
[[Category:Scripting Commands|NAME]]
+
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|NAME]]
+
[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.46|NAME]]
+
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA|NAME]]
+
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
 +
[[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 15:03, 2 September 2019

Introduced with Operation Flashpoint version1.00
  

Click on the images for descriptions

Introduced in

Game:
Operation Flashpoint
Version:
1.00

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.
When argument is Location, the location's name is returned. To return the textual value of a location use text command instead.

Arma 3 logo black.png
setName can be used on a person to set name. However in multiplayer name always returns profileName.

Syntax

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

Alternative Syntax

Syntax:
name location
Parameters:
location: Location
Return Value:
String

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"

Additional Information

Multiplayer:
-
See also:
profileNamesetNamenameSoundsetNameSoundcreateLocationdeleteLocationdrawLocationlocationPositionlocationNullnearestLocationnearestLocationsnearestLocationWithDubbing

Notes

Only post proven facts here. Report bugs on the feedback tracker. Use the talk page or the forums for discussions.
Add New Note | How To

Notes

kju
Location variant appears to be only for the 3d editor.
Posted on August 4, 2006 - 10:56
hardrock
Notes from before the conversion: Name will return an error for units that have been dead for more than a few seconds.
Posted on December 15, 2006 - 05:27
Kronzky
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: hint format ["Unit's name: %1", _unitobject];
Posted on April 14, 2009
alef
Will return Error: No vehicle for JIP players in init.sqf, if no sleep were performed

Bottom Section