diag log: Difference between revisions

From Bohemia Interactive Community
(Update killzone's link, fix comment formatting)
(added seeAlso)
 
(63 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:diag_log}}
{{RV|type=command
{{Command|= Comments
____________________________________________________________________________________________


| arma2 |= Game name
|game1= arma2
|version1= 1.00


|1.00|= Game version
|game2= arma2oa
____________________________________________________________________________________________
|version2= 1.50


| Dumps the argument's value to the [[arma.RPT|report file]]. Each call creates a new line in the file. |= Description
|game3= tkoh
____________________________________________________________________________________________
|version3= 1.00


| '''diag_log''' anything |= Syntax
|game4= arma3
|version4= 0.50


|p1= anything: [[Anything]] -  |= PARAMETER1
|gr1= Diagnostic


|p2= |= PARAMETER2
|descr= Dumps the argument's value to the [[arma.RPT|report file]]. Each call creates a new line in the file.


|p3= |= PARAMETER3
|s1= [[diag_log]]  output


| [[Nothing]] |= RETURNVALUE
|p1= output: [[Anything]]


|r1= [[Nothing]]


|x1= <code>[[diag_log]] [[time]];</code>|= Example 1
|x1= <sqf>diag_log time;</sqf>
|x2= <code>[[diag_log]] [[format]] ["%1, %2", [[player]], [[time]]<nowiki>]</nowiki>;</code>|= Example 2
 
|x3= <code>_arr = [1, "foo", [[player]], "bar"];
|x2= <sqf>diag_log format ["%1, %2", player, time];</sqf>
 
|x3= <sqf>
_array = [1, "foo", player, "bar"];
{
{
    [[diag_log]] [[Magic Variables|_x]];
diag_log _x;
} [[forEach]] _arr; // Creates 4 entries on 4 lines</code>|= Example 3
} forEach _array ; // creates 4 entries on 4 lines
|x4= <code>_arr = [1, "foo", [[player]], "bar"];
</sqf>
[[diag_log]] _arr;</code>
Creates one entry of e.g. {{Inline code|[1,"foo",B Alpha 1-1:1 (Player Name),"bar"]}}|= Example 4
 
____________________________________________________________________________________________


| [[arma.RPT]], [[copyToClipboard]], [[copyFromClipboard]], [[diag_fps]], [[diag_fpsMin]], [[diag_frameNo]], [[diag_tickTime]] |= SEEALSO
|x4= <sqf>
_array = [1, "foo", player, "bar"];
diag_log _array; // Creates one entry of e.g. [1,"foo",B Alpha 1-1:1 (Player Name),"bar"]
</sqf>


| |= MPBEHAVIOUR
|seealso= [[arma.RPT]] [[diag_dumpCalltraceToLog]] [[diag_stacktrace]] [[copyToClipboard]] [[copyFromClipboard]] [[diag_fps]] [[diag_fpsMin]] [[diag_frameNo]] [[diag_tickTime]] [[diag_deltaTime]]
____________________________________________________________________________________________
}}
}}


<h3 style='display:none'>Notes</h3>
<dl class="command_description">
<dl class='command_description'>
<!-- Note Section BEGIN -->
<dt class="note">[[User:Worldeater|Worldeater]]
<dd class="note">
ARMA2 crashes when ''diag_log'' is fed more than 1019 characters. ''diag_log'' might also crash ARMA2 when fed with less characters in some cases.<br/><br/>
Note: This issue has been fixed in patch 1.04


<dt class="note">[[User:Master85|Master85]]
<dt><dt>
<dd class="notedate">Posted 22:39, 8 June 2009</dd>
<dt class="note">[[User:Master85|Master85]]</dt>
<dd class="note">
<dd class="note">
To dump a string without "" use [[text]].
To dump a string without "" use [[text]].
 
<dt><dt>
<!-- Obnoxious number of spaces prevents short comments from inadvertently formatting the next comment like a reply -->
<dd class="notedate">Posted 23:35, 19 April 2011</dd>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<dt class="note">[[User:Demonized|Demonized]]</dt>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
<dt class="note">[[User:Demonized|Demonized]]
<dd class="note">
<dd class="note">
in patch 1.59 there is a limit of 1044 characters to be printed, no error or crash but diag_log line will simply end at character number 1044.
in patch 1.59 there is a limit of 1044 characters to be printed, no error or crash but diag_log line will simply end at character number 1044.
<!-- Obnoxious number of spaces prevents short comments from inadvertently formatting the next comment like a reply -->
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<dt class="note">[[User:Killzone_Kid|Killzone_Kid]]
<dd class="note">
For convenience and easy debugging use my free [http://killzonekid.com/arma-console-extension-debug_console-dll-v3-0/ debug_console] extension which will automatically launch a console window with your output. It can also write to file. To install drop ''debug_console.dll'' into main Arma directory.
Examples:
<code>"debug_console" [[callExtension]] "Default grey"; //default output
"debug_console" [[callExtension]] "Red line without timestamp #1000"; //red with timestamp
"debug_console" [[callExtension]] "Yellow line with timestamp #1101"; //yellow without timestamp
"debug_console" [[callExtension]] "Writing to file ~0001"; //output to file
"debug_console" [[callExtension]] ""; //empty line
"debug_console" [[callExtension]] "A"; //beep sound
"debug_console" [[callExtension]] "C"; //clear console
"debug_console" [[callExtension]] "X"; //close console</code>
Direct Download: http://killzonekid.com/pub/debug_console_v3.0.zip
<dd class="note">
Update | See [http://killzonekid.com/tag/debug-console/ '''http://killzonekid.com/tag/debug-console/'''] for documentation and current versions (including x64) of Killzone's tool.
    [[User:Tofof|Tofof]] ([[User talk:Tofof|talk]]) 22:06, 27 March 2017 (CEST)
<!-- Note Section END -->
</dl>
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:ArmA 2: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 21:47, 11 December 2023

Logo A2.png 1.00A2 OA Logo.png 1.50tkoh logo small.png 1.00Arma 3 logo black.png 0.50
Hover & click on the images for description

Description

Description:
Dumps the argument's value to the report file. Each call creates a new line in the file.
Groups:
Diagnostic

Syntax

Syntax:
diag_log output
Parameters:
output: Anything
Return Value:
Nothing

Examples

Example 1:
diag_log time;
Example 2:
diag_log format ["%1, %2", player, time];
Example 3:
_array = [1, "foo", player, "bar"]; { diag_log _x; } forEach _array ; // creates 4 entries on 4 lines
Example 4:
_array = [1, "foo", player, "bar"]; diag_log _array; // Creates one entry of e.g. [1,"foo",B Alpha 1-1:1 (Player Name),"bar"]

Additional Information

See also:
arma.RPT diag_dumpCalltraceToLog diag_stacktrace copyToClipboard copyFromClipboard diag_fps diag_fpsMin diag_frameNo diag_tickTime diag_deltaTime

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 22:39, 8 June 2009
Master85
To dump a string without "" use text.
Posted 23:35, 19 April 2011
Demonized
in patch 1.59 there is a limit of 1044 characters to be printed, no error or crash but diag_log line will simply end at character number 1044.
Retrieved from "https://community.bistudio.com/wiki?title=diag_log&oldid=351628"