typeName: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<dl class="command_description"> <dt></dt>" to "<dl class="command_description"> <dt></dt>")
m (Fix)
 
(74 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma1
|game1= arma1
|version1= 1.00


|1.00
|game2= arma2
|version2= 1.00
 
|game3= arma2oa
|version3= 1.50
 
|game4= tkoh
|version4= 1.00
 
|game5= arma3
|version5= 0.50


|gr1= Variables
|gr1= Variables


| Returns the [[:Category:Data Types|data type]] of an expression.  
|descr= Returns the [[:Category:Data Types|Data Type]] of an expression.  


The type is returned as on of the following all-uppercase strings:
The type is returned as on of the following all-uppercase strings:
{{Columns|5|
* "[[Array|ARRAY]]"
* "[[Array|ARRAY]]"
* "[[Bool|BOOL]]"
* "[[Boolean|BOOL]]"
* "[[Code|CODE]]"
* "[[Code|CODE]]"
* "[[Config|CONFIG]]"
* "[[Config|CONFIG]]"
Line 17: Line 29:
* "[[Display|DISPLAY]]"
* "[[Display|DISPLAY]]"
* "[[Group|GROUP]]"
* "[[Group|GROUP]]"
* "[[Location|LOCATION]]"
* "[[Object|OBJECT]]"
* "[[Object|OBJECT]]"
* "[[Scalar|SCALAR]]"
* "[[Number|SCALAR]]" (and "[[Number|NaN]]")
* "[[Script|SCRIPT]]"
* "[[Script Handle|SCRIPT]]"
* "[[Side|SIDE]]"
* "[[Side|SIDE]]"
* "[[String|STRING]]"
* "[[String|STRING]]"
* "[[Text|TEXT]]"
* "[[Structured Text|TEXT]]"
* "[[Team Member|TEAM_MEMBER]]"
* {{GVI|arma1|1.08|size= 0.75}} "[[Location|LOCATION]]"
* "[[Namespace|NAMESPACE]]"
* {{GVI|arma2|1.00|size= 0.75}} "[[Team Member|TEAM_MEMBER]]"
* "[[Diary Record|DIARY_RECORD]]"
* {{GVI|arma2|1.00|size= 0.75}} "[[Namespace|NAMESPACE]]"
* "[[Task|TASK]]"
* {{GVI|arma2|1.00|size= 0.75}} "[[Diary Record|DIARY_RECORD]]"
* "[[HashMap|HASHMAP]]"
* {{GVI|arma2|1.00|size= 0.75}} "[[Task|TASK]]"
They represent the available [[Data_Types|data types]] in Arma.
* {{GVI|arma3|2.02|size= 0.75}} "[[HashMap|HASHMAP]]"
{{Feature|Informative|For comparing types, use [[isEqualType]] command instead in {{arma3}}}}
}}
They represent the available [[:Category:Data Types|Data Types]] in {{arma}}.
{{Feature|arma3|For type comparison, use [[isEqualType]] command instead.}}


| '''typeName''' anything
|s1= [[typeName]] anything


|p1= anything: [[Anything]]
|p1= anything: [[Anything]]


|r1=[[String]]
|r1= [[String]]
 
|x1= <sqf>_msg = "hello"; _result = typeName _msg;  //_result will be "STRING"</sqf>


|x1= <code>_msg = "hello"; _result = [[typeName]] _msg;  //_result will be "STRING"</code>
|x2= <sqf>_unit = player; _result = typeName _unit; //_result becomes "OBJECT"</sqf>
|x2= <code>_unit = [[player]]; _result = [[typeName]] _unit; //_result becomes "OBJECT"</code>


|x3= Values representing direct [[:Category: Data Types| Data Types]]:<code>[[hint]] [[typeName]] 0; //SCALAR
|x3= Values representing direct [[:Category:Data Types|Data Types]]:
[[hint]] [[typeName]] ""; //STRING
<sqf>
[[hint]] [[typeName]] [[true]]; //BOOL
hint typeName 0; // SCALAR
[[hint]] [[typeName]] []; //ARRAY
hint typeName 1e39; // NaN
[[hint]] [[typeName]] {}; //CODE
hint typeName ""; // STRING
[[hint]] [[typeName]] [[objNull]]; //OBJECT
hint typeName true; // BOOL
[[hint]] [[typeName]] [[grpNull]]; //GROUP
hint typeName []; // ARRAY
[[hint]] [[typeName]] [[controlNull]]; //CONTROL
hint typeName {}; // CODE
[[hint]] [[typeName]] [[teamMemberNull]]; //TEAM_MEMBER
hint typeName scriptNull; // SCRIPT (since {{arma3}} v1.32)
[[hint]] [[typeName]] [[displayNull]]; //DISPLAY
hint typeName objNull; // OBJECT
[[hint]] [[typeName]] [[taskNull]]; //TASK
hint typeName grpNull; // GROUP
[[hint]] [[typeName]] [[locationNull]]; //LOCATION
hint typeName controlNull; // CONTROL
[[hint]] [[typeName]] [[sideUnknown]]; //SIDE
hint typeName teamMemberNull; // TEAM_MEMBER (since {{arma2}} v1.00)
[[hint]] [[typeName]] [[text]] ""; //TEXT
hint typeName displayNull; // DISPLAY
[[hint]] [[typeName]] [[configFile]]; //CONFIG
hint typeName taskNull; // TASK (since {{arma2}} v1.00)
[[hint]] [[typeName]] [[configNull]]; //CONFIG (Since Arma 3 v1.54)
hint typeName locationNull; // LOCATION
[[hint]] [[typeName]] [[missionNamespace]]; //NAMESPACE
hint typeName sideUnknown; // SIDE
[[hint]] [[typeName]] [[diaryRecordNull]]; //DIARY_RECORD (Since Arma 3 v2.00)
hint typeName text ""; // TEXT
[[hint]] [[typeName]] [[createHashMap]]; //HASHMAP (Since Arma 3 v2.02)</code>
hint typeName configFile; // CONFIG
hint typeName configNull; // CONFIG (since {{arma3}} v1.54)
hint typeName missionNamespace; // NAMESPACE
hint typeName diaryRecordNull; // DIARY_RECORD (since {{arma3}} v2.00)
hint typeName createHashMap; // HASHMAP (since {{arma3}} v2.02)
</sqf>


|x4= <code>[[if]] ([[typeName]] _this [[!=]] "ARRAY") [[exitWith]] {
|x4= <sqf>
[[hint]] "_this is not an array!"
if (typeName _this != "ARRAY") exitWith { hint "_this is not an array!" };
}
// is the same as
//is the same as  
if (typeName _this != typeName []) exitWith { hint "_this is not an array!" };
[[if]] ([[typeName]] _this [[!=]] [[typeName]] []) [[exitWith]] {
// same result but faster in {{arma3}}
[[hint]] "_this is not an array!"
if !(_this isEqualType []) exitWith { hint "_this is not an array!" };
}
</sqf>
//same result but faster in {{arma3}}
[[if]] !(_this [[isEqualType]] []) [[exitWith]] {
[[hint]] "_this is not an array!"
</code>


|seealso= [[isEqualTypeAll]], [[isEqualType]], [[isEqualTypeParams]], [[isEqualTypeArray]], [[isEqualTypeAny]], [[typeOf]], [[isKindOf]], [[isClass]], [[isArray]], [[isNumber]], [[isText]], [[isNil]], [[isNull]]
|seealso= [[isEqualTypeAll]] [[isEqualType]] [[isEqualTypeParams]] [[isEqualTypeArray]] [[isEqualTypeAny]] [[typeOf]] [[isKindOf]] [[isClass]] [[isArray]] [[isNumber]] [[isText]] [[isNil]] [[isNull]]
}}
}}


{{GameCategory|arma1|Scripting Commands}}
{{Note
{{GameCategory|arma2|Scripting Commands}}
|user= Killzone_Kid
{{GameCategory|arma3|Scripting Commands}}
|timestamp= 20160925111400
{{GameCategory|tkoh|Scripting Commands}}
|text= [[typeName]] of [[nil]] is {{hl|ANY}}, however this is not possible to test as script command is just ignored when any argument is [[nil]].
 
}}
<dl class="command_description">
 
<dt></dt>
<dd class="notedate">Posted on September 25, 2016 - 11:14 (UTC)</dd>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
<dd class="note">
[[typeName]] of [[nil]] is <tt>ANY</tt>, however this is not possible to test as script command is just ignored when any argument is [[nil]]
</dd>
</dl>

Latest revision as of 17:16, 28 September 2024

Logo 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:
Returns the Data Type of an expression. The type is returned as on of the following all-uppercase strings:

They represent the available Data Types in Arma.

Arma 3
For type comparison, use isEqualType command instead.
Groups:
Variables

Syntax

Syntax:
typeName anything
Parameters:
anything: Anything
Return Value:
String

Examples

Example 1:
_msg = "hello"; _result = typeName _msg; //_result will be "STRING"
Example 2:
_unit = player; _result = typeName _unit; //_result becomes "OBJECT"
Example 3:
Values representing direct Data Types:
hint typeName 0; // SCALAR hint typeName 1e39; // NaN hint typeName ""; // STRING hint typeName true; // BOOL hint typeName []; // ARRAY hint typeName {}; // CODE hint typeName scriptNull; // SCRIPT (since Arma 3 v1.32) hint typeName objNull; // OBJECT hint typeName grpNull; // GROUP hint typeName controlNull; // CONTROL hint typeName teamMemberNull; // TEAM_MEMBER (since Arma 2 v1.00) hint typeName displayNull; // DISPLAY hint typeName taskNull; // TASK (since Arma 2 v1.00) hint typeName locationNull; // LOCATION hint typeName sideUnknown; // SIDE hint typeName text ""; // TEXT hint typeName configFile; // CONFIG hint typeName configNull; // CONFIG (since Arma 3 v1.54) hint typeName missionNamespace; // NAMESPACE hint typeName diaryRecordNull; // DIARY_RECORD (since Arma 3 v2.00) hint typeName createHashMap; // HASHMAP (since Arma 3 v2.02)
Example 4:
if (typeName _this != "ARRAY") exitWith { hint "_this is not an array!" }; // is the same as if (typeName _this != typeName []) exitWith { hint "_this is not an array!" }; // same result but faster in Arma 3 if !(_this isEqualType []) exitWith { hint "_this is not an array!" };

Additional Information

See also:
isEqualTypeAll isEqualType isEqualTypeParams isEqualTypeArray isEqualTypeAny typeOf isKindOf isClass isArray isNumber isText isNil isNull

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
Killzone_Kid - c
Posted on Sep 25, 2016 - 11:14 (UTC)
typeName of nil is ANY, however this is not possible to test as script command is just ignored when any argument is nil.
Retrieved from "https://community.bistudio.com/wiki?title=typeName&oldid=369624"