BIS fnc logFormatServer: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " *\| *([Cc]omments|COMMENTS|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments \("local" or "global"\)|Multiplayer Effects \("local" or "global"\)|Multiplayer Execution \("server" o...)
m (unified msg style)
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Function
{{RV|type=function


| arma3
|game1= arma3
|version1= 1.00


|1.00
|gr1= Diagnostic


|gr1 = Diagnostic
|descr= Logs (using [[diag_log]]) a debug message ([[profileName]], [[getPlayerUID|playerUID]], [[Magic Variables#fnc_scriptName|_fnc_scriptName]], provided text) to '''server'''<nowiki/>'s [[Crash Files|.RPT]]. In singleplayer, [[BIS_fnc_logFormat]] is used.
{{Feature|informative|{{hl|[[Description.ext#allowFunctionsLog|allowFunctionsLog]]}} has to be set to '''1''' in [[Description.ext]] for this function to have any effect.}}


| Logs (using [[diag_log]]) a debug message ([[profileName]], [[getPlayerUID|playerUID]], [[Magic Variables#fnc_scriptName|_fnc_scriptName]], provided text) to '''server'''<nowiki/>'s [[Crash Files|.RPT]]. In singleplayer, [[BIS_fnc_logFormat]] is used.
|s1= [text, argument1, argument2, ...] call [[BIS_fnc_logFormatServer]]
{{Informative | [[Description.ext#allowFunctionsLog|allowFunctionsLog]] must be enabled.}}
 
| [text, argument1, argument2, ...] call [[BIS_fnc_logFormatServer]]


|p1= text: [[String]] or [[Anything]] - text using [[format]] standard (with %). Any non-[[String]] value will be converted (with [[str]])
|p1= text: [[String]] or [[Anything]] - text using [[format]] standard (with %). Any non-[[String]] value will be converted (with [[str]])
Line 16: Line 15:
|p2= argument1..n: [[Anything]] - same as [[format]] arguments - referenced in ''text'' as %1, %2 etc
|p2= argument1..n: [[Anything]] - same as [[format]] arguments - referenced in ''text'' as %1, %2 etc


| [[Boolean]] - [[true]] when done
|r1= [[Boolean]] - [[true]] when done


|x1= <code>[[private]] _currentFPS = [[diag_fps]];
|x1= <sqf>private _currentFPS = diag_fps;
[[if]] (_currentFPS < 10) [[then]]
if (_currentFPS < 10) then
{
{
["Player %1 has performance issues (%2 FPS)", [[name]] [[player]], _currentFPS] [[call]] [[BIS_fnc_logFormatServer]];
["Player %1 has performance issues (%2 FPS)", name player, _currentFPS] call BIS_fnc_logFormatServer;
};</code>
};
</sqf>


| [[diag_log]] [[BIS_fnc_log]] [[BIS_fnc_logFormat]]
|seealso= [[BIS_fnc_error]] [[BIS_fnc_logFormat]] [[BIS_fnc_errorMsg]] [[BIS_fnc_log]]
}}
}}

Latest revision as of 22:45, 30 December 2023

Hover & click on the images for description

Description

Description:
Logs (using diag_log) a debug message (profileName, playerUID, _fnc_scriptName, provided text) to server's .RPT. In singleplayer, BIS_fnc_logFormat is used.
allowFunctionsLog has to be set to 1 in Description.ext for this function to have any effect.
Execution:
call
Groups:
Diagnostic

Syntax

Syntax:
[text, argument1, argument2, ...] call BIS_fnc_logFormatServer
Parameters:
text: String or Anything - text using format standard (with %). Any non-String value will be converted (with str)
argument1..n: Anything - same as format arguments - referenced in text as %1, %2 etc
Return Value:
Boolean - true when done

Examples

Example 1:
private _currentFPS = diag_fps; if (_currentFPS < 10) then { ["Player %1 has performance issues (%2 FPS)", name player, _currentFPS] call BIS_fnc_logFormatServer; };

Additional Information

See also:
BIS_fnc_error BIS_fnc_logFormat BIS_fnc_errorMsg BIS_fnc_log

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