assert: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\| *(arg|eff|mp|serverExec|gr[0-9]) *= *(.*) * *\|([^=]{12})" to "|$1=$2 |descr=$3")
m (Some wiki formatting)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


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


|gr1= Program Flow
|gr1= Program Flow


|descr=1.00
|descr= Tests a condition and if the condition is false, displays error on screen (if -showscripterrors enabled) and logs error into .rpt file. It does not interrupt the script execution.
 
| Tests a condition and if the condition is false, displays error on screen (if -showscripterrors enabled) and logs error into .rpt file. It does not interrupt the script execution.


If script was pre-processed with [[preprocessFileLineNumbers]], it will also show/log the error line number and the file name.
If script was pre-processed with [[preprocessFileLineNumbers]], it will also show/log the error line number and the file name.


|s1= '''assert''' condition
|s1= [[assert]] condition


|p1= condition: [[Boolean]]
|p1= condition: [[Boolean]]
Line 17: Line 28:
|r1=[[Boolean]] - mirrors condition
|r1=[[Boolean]] - mirrors condition


|x1= <code>[[assert]] (1>2);</code>  
|x1= <code>[[assert]] (1 &gt; 2);</code>  


[[Image:PreprocessFile.jpg]]
[[Image:PreprocessFile.jpg]]
Line 29: Line 40:
[[typeName]] _1 == "STRING" &&  
[[typeName]] _1 == "STRING" &&  
[[typeName]] _2 == "SCALAR"
[[typeName]] _2 == "SCALAR"
)) [[exitWith]] {<nowiki>/*</nowiki>optional error logging<nowiki>*/</nowiki>};
)) [[exitWith]] { {{codecomment|/* optional error logging */}} };
[[hint]] "Alright!";
[[hint]] "Alright!";
};
};
[1,2,3] [[call]] some_func; //assert error
[1,2,3] [[call]] some_func; {{cc|assert error}}
<nowiki>[</nowiki>[1],"2",3] [[call]] some_func; //Alright!</code>
[<nowiki/>[1],"2",3] [[call]] some_func; {{cc|Alright!}}</code>


|seealso= [[try]], [[catch]], [[throw]], [[halt]], [[diag_captureFrame]], [[diag_captureSlowFrame]], [[diag_logSlowFrame]]
|seealso= [[try]], [[catch]], [[throw]], [[halt]], [[diag_captureFrame]], [[diag_captureSlowFrame]], [[diag_logSlowFrame]]
Line 43: Line 54:
<dd class="notedate">Posted on May 15, 2010 - 0:01</dd>
<dd class="notedate">Posted on May 15, 2010 - 0:01</dd>
<dt class="note">[[User:Roehre|Roehre]]</dt>
<dt class="note">[[User:Roehre|Roehre]]</dt>
<dd class="note">Returns false, if condition is false, and returns true, if condition is true.
<dd class="note">Returns false, if condition is false, and returns true, if condition is true.</dd>
 
</dl>
</dl>
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Revision as of 22:56, 13 June 2021

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:
Tests a condition and if the condition is false, displays error on screen (if -showscripterrors enabled) and logs error into .rpt file. It does not interrupt the script execution. If script was pre-processed with preprocessFileLineNumbers, it will also show/log the error line number and the file name.
Groups:
Program Flow

Syntax

Syntax:
assert condition
Parameters:
condition: Boolean
Return Value:
Boolean - mirrors condition

Examples

Example 1:
assert (1 > 2); PreprocessFile.jpg
Example 2:
Check function params (Faster alternative to BIS_fnc_param)some_func = { _0 = _this select 0; _1 = _this select 1; _2 = _this select 2; if (!assert ( typeName _0 == "ARRAY" && typeName _1 == "STRING" && typeName _2 == "SCALAR" )) exitWith { /* optional error logging */ }; hint "Alright!"; }; [1,2,3] call some_func; // assert error [[1],"2",3] call some_func; // Alright!

Additional Information

See also:
trycatchthrowhaltdiag_captureFramediag_captureSlowFramediag_logSlowFrame

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
Posted on May 15, 2010 - 0:01
Roehre
Returns false, if condition is false, and returns true, if condition is true.
Retrieved from "https://community.bistudio.com/wiki?title=assert&oldid=279164"