setVehicleVarName: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<code>([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "<code>$1$2$3</code>")
m (Some wiki formatting)
 
(11 intermediate revisions by the same user not shown)
Line 24: Line 24:
|descr= Sets string representation of an object to a custom string.<br>
|descr= Sets string representation of an object to a custom string.<br>
When a vehicle is created and named in the editor, the name becomes both the variable containing the vehicle object and the string representation of the vehicle object.
When a vehicle is created and named in the editor, the name becomes both the variable containing the vehicle object and the string representation of the vehicle object.
In scripts an extra step is needed to achieve the same effect. See [[{{PAGENAME}}#Example 1|Example 1]].
In scripts an extra step is needed to achieve the same effect - see {{Link|#Example 1}}.


{{Feature|arma3|This does not work with [[Arma 3: Simple Objects|Simple Objects]].}}
{{Feature|arma3|This does not work with [[Arma 3: Simple Objects|Simple Objects]].}}
Line 36: Line 36:
|r1= [[Nothing]]
|r1= [[Nothing]]


|x1= <code>private _playersCar = vehicle player;
|x1= <sqf>
[[systemChat]] [[str]] _playersCar; // displays e.g "ce06b00# 164274: offroad_01_unarmed_f.p3d"
private _playersCar = vehicle player;
systemChat str _playersCar; // displays e.g "ce06b00# 164274: offroad_01_unarmed_f.p3d"


_playersCar [[setVehicleVarName]] "MyOffroad";
_playersCar setVehicleVarName "MyOffroad";
[[systemChat]] [[str]] _playersCar; // displays "MyOffroad"
systemChat str _playersCar; // displays "MyOffroad"


[[isNil]] "MyOffroad"; // [[true]] - the MyOffroad '''variable''' is not set
isNil "MyOffroad"; // true - the MyOffroad variable is not set
MyOffroad = _playersCar; // now it is
MyOffroad = _playersCar; // now it is
[[publicVariable]] "MyOffroad"; // broadcasts it over the network</code>
publicVariable "MyOffroad"; // broadcasts it over the network
</sqf>


|x2= <code>_offroad setVehicleVarName ""; // Reset string representation to the default value</code>
|x2= <sqf>_offroad setVehicleVarName ""; // Reset string representation to the default value</sqf>


|seealso= [[vehicleVarName]] [[BIS_fnc_objectVar]]
|seealso= [[vehicleVarName]] [[BIS_fnc_objectVar]]
}}
}}

Latest revision as of 16:21, 20 March 2023

Hover & click on the images for description

Description

Description:
Sets string representation of an object to a custom string.
When a vehicle is created and named in the editor, the name becomes both the variable containing the vehicle object and the string representation of the vehicle object. In scripts an extra step is needed to achieve the same effect - see Example 1.
Arma 3
This does not work with Simple Objects.
Groups:
Object Manipulation

Syntax

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

Examples

Example 1:
private _playersCar = vehicle player; systemChat str _playersCar; // displays e.g "ce06b00# 164274: offroad_01_unarmed_f.p3d" _playersCar setVehicleVarName "MyOffroad"; systemChat str _playersCar; // displays "MyOffroad" isNil "MyOffroad"; // true - the MyOffroad variable is not set MyOffroad = _playersCar; // now it is publicVariable "MyOffroad"; // broadcasts it over the network
Example 2:
_offroad setVehicleVarName ""; // Reset string representation to the default value

Additional Information

See also:
vehicleVarName BIS_fnc_objectVar

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