BIS fnc logFormatServer: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " |r1=[[" to " |r1= [[")
m (unified msg style)
 
(4 intermediate revisions by 2 users not shown)
Line 7: Line 7:


|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.
|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 | [[Description.ext#allowFunctionsLog|allowFunctionsLog]] must be enabled.}}
{{Feature|informative|{{hl|[[Description.ext#allowFunctionsLog|allowFunctionsLog]]}} has to be set to '''1''' in [[Description.ext]] for this function to have any effect.}}


|s1=[text, argument1, argument2, ...] call [[BIS_fnc_logFormatServer]]
|s1= [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 17: Line 17:
|r1= [[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>


|seealso= [[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