BIS fnc error: Difference between revisions

Latest revision as of 00:23, 12 February 2024

0.50

Hover & click on the images for description

Description

Description:

Logs an error message and shows an ingame error message. The message is shown when either of the following is true:

In 2D Editor
In Eden Editor via BIS_fnc_3DENNotification
Display 313 (Eden Editor display) is available
profileNamespace getVariable ["BIS_fnc_init_displayErrors", false] is set to true.

Output format:

In multiplayer (isMultiplayer) the function will add the profileName in front of the message
If _fnc_error_exit is set to true before the function call, the log message will display HALT: instead of ERROR:
If function is called from within another function, the name of the parent function will be displayed. This can be overwritten by setting _fnc_scriptName to a custom value

ⓘ

allowFunctionsLog has to be set to 1 in Description.ext for this function to have any effect.

Execution:

call

Groups:

Diagnostic

Syntax

Syntax:: [message, param1, ..., paramN] call BIS_fnc_error
Parameters:: message: String - (formatted) logged message
: param1..paramN: Anything - (Optional) format arguments, if any
Return Value:: Array in format: [message, param1..paramN]

Examples

Example 1:: ["Player is too far away (%1 metres)", round (player distance [0, 0, 0])] call BIS_fnc_error;
Example 2:: // some useful function cases if (!isServer) exitWith { ["This function must run on the server"] call BIS_fnc_error }; if (!hasInterface) exitWith { ["This function must not run on a headless machine"] call BIS_fnc_error }; if (!local _vehicle) exitWith { ["This function must run on the vehicle owner's machine"] call BIS_fnc_error };
Example 3:: // Change rpt log to "HALT" indicating that function exited private _fnc_error_exit = true; if (exitHere) exitWith { "Some error message!" call BIS_fnc_error; // Output in rpt: "log: HALT: [BIS_fnc_debugConsoleExec] Some error message!" };
Example 4:: private _fnc_scriptName = "My_Awesome_Custom_Function"; "Some error message!" call BIS_fnc_error; // Output in rpt: "log: ERROR: [My_Awesome_Custom_Function] Some error message!"

Additional Information

See also:: BIS_fnc_errorMsg BIS_fnc_log BIS_fnc_logFormat BIS_fnc_logFormatServer

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

@@ Line 1: / Line 1: @@
+{{RV|type=function
-{{Function|= Comments
+|game1= arma3
-____________________________________________________________________________________________
+|version1= 0.50
-| tkoh |= Game name
+|gr1= Diagnostic
-|1.00|= Game version
+|descr= [[File:BIS_fnc_error.png|300px|right]]
-____________________________________________________________________________________________
+Logs an error message and shows an ingame error message. The message is shown when either of the following is true:
-| <pre>/*
+* In [[2D Editor]]
+* In [[Eden Editor]] via [[BIS_fnc_3DENNotification]]
+* Display {{hl|313}} ([[Eden Editor]] display) is available
+* <sqf inline>profileNamespace getVariable ["BIS_fnc_init_displayErrors", false]</sqf> is set to <sqf inline>true</sqf>.
-	Description:
+'''Output format:'''
-	Display error message
-	Parameter(s):
+* In multiplayer ([[isMultiplayer]]) the function will add the [[profileName]] in front of the message
-	_this select 0: STRING - Formatted message
+* If <sqf inline>_fnc_error_exit</sqf> is set to <sqf inline>true</sqf> before the function call, the log message will display {{hl|HALT:}} instead of {{hl|ERROR:}}
-	_this select n (Optional): ANY - additional parameters
+* If function is called from within another function, the name of the parent function will be displayed. This can be overwritten by setting <sqf inline>_fnc_scriptName</sqf> to a custom value
-	Returns:
+{{Feature|informative|{{hl|[[Description.ext#allowFunctionsLog|allowFunctionsLog]]}} has to be set to '''1''' in [[Description.ext]] for this function to have any effect.}}
-	STRING - displayed message
-*/
-</pre><small>''(Placeholder description extracted from the function header by [[BIS_fnc_exportFunctionsToWiki]])''</small> |= Description
+|s1= [message, param1, ..., paramN] call [[BIS_fnc_error]]
-____________________________________________________________________________________________
-| <!-- [] call [[BIS_fnc_error]]; --> |= Syntax
+|p1= message: [[String]] - ([[format]]ted) logged message
-|p1= |= Parameter 1
+|p2= param1..paramN: [[Anything]] - (Optional) [[format]] arguments, if any
-| |= Return value
+|r1= [[Array]] in format: [message, param1..paramN]
-____________________________________________________________________________________________
-|x1= <code></code> |=
+|x1= <sqf>["Player is too far away (%1 metres)", round (player distance [0, 0, 0])] call BIS_fnc_error;</sqf>
-____________________________________________________________________________________________
-| |= See also
+|x2= <sqf>
+// some useful function cases
+if (!isServer) exitWith { ["This function must run on the server"] call BIS_fnc_error };
+if (!hasInterface) exitWith { ["This function must not run on a headless machine"] call BIS_fnc_error };
+if (!local _vehicle) exitWith { ["This function must run on the vehicle owner's machine"] call BIS_fnc_error };
+</sqf>
-}}
+|x3= <sqf>
+// Change rpt log to "HALT" indicating that function exited
+private _fnc_error_exit = true;
+if (exitHere) exitWith
+{
+	"Some error message!" call BIS_fnc_error; // Output in rpt: "log: HALT: [BIS_fnc_debugConsoleExec] Some error message!"
+};
+</sqf>
-<h3 style="display:none">Notes</h3>
+|x4= <sqf>
-<dl class="command_description">
+private _fnc_scriptName = "My_Awesome_Custom_Function";
-<!-- Note Section BEGIN -->
+"Some error message!" call BIS_fnc_error; // Output in rpt: "log: ERROR: [My_Awesome_Custom_Function] Some error message!"
+</sqf>
-<!-- Note Section END -->
+|seealso= [[BIS_fnc_errorMsg]] [[BIS_fnc_log]] [[BIS_fnc_logFormat]] [[BIS_fnc_logFormatServer]]
-</dl>
+}}
-<h3 style="display:none">Bottom Section</h3>
-[[Category:Function Group: Debug|{{uc:error}}]]
-[[Category:Functions|{{uc:error}}]]
-[[Category:{{Name|tkoh}}: Functions|{{uc:error}}]]
-[[Category:{{Name|arma3}}: Functions|{{uc:error}}]]