setName: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>")
(Fix versions)
 
Line 24: Line 24:
|gr2= Locations
|gr2= Locations


|descr= Sets the name of a location or a person. In Arma 3 this can be used to set [[name]] of a person but only in single player.
|descr= Sets the name of a location or a person (person only in single player).


|s1= unit [[setName]] name
|s1= thing [[setName]] name


|p1= unit: [[Object]]
|p1= thing: [[Location]] or {{GVI|arma3|1.02|size= 0.75}} [[Object]]


|p2= name: [[String]]
|p2= name: [[String]]
Line 35: Line 35:


|s2= unit [[setName]] [name, firstName, lastName]
|s2= unit [[setName]] [name, firstName, lastName]
|s2since= arma3 1.02


|p21= unit: [[Object]]
|p21= unit: [[Object]]
Line 45: Line 47:


|r2= [[Nothing]]
|r2= [[Nothing]]
|s3= location [[setName]] name
|p41= location: [[Location]]
|p42= name: [[String]]
|r3=[[Nothing]]


|x1= <sqf>myLocation setName "My Location Name";</sqf>
|x1= <sqf>myLocation setName "My Location Name";</sqf>
Line 63: Line 57:
}}
}}


<dl class="command_description">
{{Note
 
|user= Pierre MGI
<dt></dt>
|timestamp= 20140818221500
<dd class="notedate">Posted on September 19, 2013‎</dd>
|text= Only last name will appear in command bar i.e. <sqf inline>this setName _myNameArray</sqf> will display <sqf inline>_myNameArray select 2</sqf>.
<dt class="note">[[User:Druid|Druid]]</dt>
If [[setName]] is used with a string e.g <sqf inline>this setName "blah"</sqf>, nothing occurs in the command bar and the default randomized name is displayed.<br><br>
<dd class="note">Support of a person as the first parameter from Arma 3 v. 1.02.
Dealing with the units' names in a script, _x (in a <sqf inline>forEach units _group</sqf>, for example) will return the "object" as {{hl|B ALFA 4-1:2}} or the name written in ai unit name field in editor (if exists).
<dt><dt>
This context is rather a "variable name" for each object (ai) than an "identity name" as given ''via'' the [[setName]] command.
<dd class="notedate">Posted on April 12, 2014</dd>
}}
<dt class="note">[[User:Waffle SS.|Waffle SS.]]</dt>
<dd class="note">Seems to have no effect on players in Multiplayer. (Arma 3 v1.00)
<dt><dt>
<dd class="notedate">Posted on August 18, 2014</dd>
<dt class="note">[[User:Pierre MGI|Pierre MGI]]</dt>
<dd class="note">Only last name will appear in command bar i.e. this setname _mynameArray will display _mynameArray select 2. If setname is used with a string : this setname "blah", nothing occurs in command bar and default randomized name is displayed.
<br><br>
Dealing with the units' names in a script, _x (in a foreach units group, for example) will return the "object" as B ALFA 4-1:2 or the name written in ai unit name field in editor (if exists). This context is rather a "variable name" for each object (ai) than an "identity name" as given via setname function.
<BR><BR>
</dl>

Latest revision as of 19:35, 20 April 2023

Hover & click on the images for description

Description

Description:
Sets the name of a location or a person (person only in single player).
Groups:
Unit IdentityLocations

Syntax

Syntax:
thing setName name
Parameters:
thing: Location or Arma 3 logo black.png1.02 Object
name: String
Return Value:
Nothing

Alternative Syntax

Syntax:
unit setName [name, firstName, lastName]
Parameters:
unit: Object
name: String
firstName: String
lastName: String
Return Value:
Nothing

Examples

Example 1:
myLocation setName "My Location Name";
Example 2:
player setName "New Name";
Example 3:
player setName ["Ben Kerry","Ben","Kerry"];

Additional Information

See also:
name nameSound setNameSound setIdentity

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 Aug 18, 2014 - 22:15 (UTC)
Only last name will appear in command bar i.e. this setName _myNameArray will display _myNameArray select 2. If setName is used with a string e.g this setName "blah", nothing occurs in the command bar and the default randomized name is displayed.

Dealing with the units' names in a script, _x (in a forEach units _group, for example) will return the "object" as B ALFA 4-1:2 or the name written in ai unit name field in editor (if exists). This context is rather a "variable name" for each object (ai) than an "identity name" as given via the setName command.