preprocessFileLineNumbers: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Text replacement - "[[Image:" to "[[File:")
(63 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= ofpe
|version1= 1.00


|1.00|= Game version
|game2= arma1
____________________________________________________________________________________________
|version2= 1.00


| Returns the preprocessed content of the given file. The preprocessor is C-like, it supports comments using // or /* and */ and [[PreProcessor_Commands]]. The preprocessor add also a default debug entrypoint for compiler at the begining of script: <tt>#line 1 "aFilename"</tt><br><br>
|game3= arma2
|version3= 1.00
 
|game4= arma2oa
|version4= 1.50
 
|game5= tkoh
|version5= 1.00
 
|game6= arma3
|version6= 0.50
 
|gr1= System
 
|descr= Returns the preprocessed content of the given file. The preprocessor is C-like, it supports comments using /* */ and [[PreProcessor Commands]]. The preprocessor also adds a default debug entrypoint for compiler at the begining of script: {{hl|#line 1 "aFilename"}}<br><br>


The '''#line''' keyword can be used in any script that are not preprocess, or with preprocess script with extra macro to protect reserverd sharp character. The format is:<br>
The '''#line''' keyword can be used in any script that are not preprocess, or with preprocess script with extra macro to protect reserverd sharp character. The format is:<br>
<tt>'''#line''' <number> "<name>"</tt><br>
{{hl|'''#line''' <number> "<name>"}}<br>
followed by new line. <number> could be only positive integer and <name> could be any name. This will be used only if an error occurs in the script. The error will contain the line:
followed by new line. <number> could be only positive integer and <name> could be any name. This will be used only if an error occurs in the script. The error will contain the line:
<tt>File <filename>, line <linenumber></tt><br>
{{hl|File <filename>, line <linenumber>}}<br>
where <filename> will be the <name> you set and <linenumber> will be <number> + how many lines it is from the '''#line''' line. If the error happened on the line right under '''#line''' it will add 0 to <number>, if on second line, it will add 1 etc.<br><br>
where <filename> will be the <name> you set and <linenumber> will be <number> + how many lines it is from the '''#line''' line. If the error happened on the line right under '''#line''' it will add 0 to <number>, if on second line, it will add 1 etc.<br><br>
It is possible to use more than one '''#line''' keywords, but it seems having just one at the top of the script is enough to pinpoint position of the error easily.   |= Description
It is possible to use more than one '''#line''' keywords, but it seems having just one at the top for little script is enough to pinpoint position of the error easily.  
____________________________________________________________________________________________
{{Feature | Warning | If the file you are loading is not prepared using UTF-8 encoding and contains some characters [[toArray | with codes]] > 127, they might convert incorrectly}}


| '''preprocessFileLineNumbers''' fileName |= Syntax
|s1= [[preprocessFileLineNumbers]] fileName


|p1= fileName: [[String]] - path to the file |= Parameter 1
|p1= fileName: [[String]] - path to the file


| [[String]] - file content containing <tt>#line 1 "aFilename"</tt> |= Return value
|r1= [[String]] - file content containing {{hl|#line 1 "aFilename"}}
____________________________________________________________________________________________
 
 
|x1= <sqf>_string = preprocessFileLineNumbers "A3\ui_f\scripts\IGUI\RscUnitInfo.sqf"</sqf>
|x1= <code>_string = [[preprocessFileLineNumbers]] "A3\ui_f\scripts\IGUI\RscUnitInfo.sqf"</code>  


Result is: <br>
Result is: <br>
  #line 1 "A3\ui_f\scripts\IGUI\RscUnitInfo.sqf"<br>
  #line 1 "A3\ui_f\scripts\IGUI\RscUnitInfo.sqf"<br>
  disableserialization;<br>
  disableserialization;<br>
  ........ |= Example 1
  ........
____________________________________________________________________________________________


| [[preprocessFile]], [[loadFile]], [[Function]], [[SQF syntax]], [[call]], [[spawn]], [[execVM]], [[PreProcessor Commands]] |= See also
|seealso= [[fileExists]] [[preprocessFile]] [[loadFile]] [[Function]] [[SQF Syntax]] [[call]] [[spawn]] [[execVM]] [[PreProcessor Commands]]
}}


{{Note
|user= Killzone_Kid
|timestamp= 20131217134400
|text= The main difference between [[preprocessFile]] and [[preprocessFileLineNumbers]] is that the latter adds #line keyword to the target file, which allows to log the __LINE__ error happened at and the __FILE__ error happened in.<br>
[[File:PreprocessFile.jpg]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= code34
<!-- Note Section BEGIN -->
|timestamp= 20171104101600
<dd class="notedate">Posted on December 17, 2013
|text= The #line directive get's removed from the output.<br>
<dt class="note">'''[[User:Killzone_Kid|Killzone_Kid]]'''
So to add a custom #line directive before while using preprocessFileLineNumbers, you have to use a preprocessor macro like this:<br>
<dd class="note">The main difference between [[preprocessFile]] and [[preprocessFileLineNumbers]] is that the latter adds #line keyword to the target file, which allows to log the __LINE__ error happened at and the __FILE__ error happened in.
 
[[Image:PreprocessFile.jpg]]
 
<!-- Note Section END -->
</dl>
 
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|PREPROCESSFILELINENUMBERS]]
[[Category:Scripting Commands OFP Elite |PREPROCESSFILELINENUMBERS]]
[[Category:Scripting Commands ArmA|PREPROCESSFILELINENUMBERS]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on November 4, 2017 - 10:16 (UTC)</dd>
<dt class="note">[[User:code34|code34]]</dt>
<dd class="note">
To custom #line directive with preprocessFileLineNumbers activate, you can use a preprocess macro like this:<br>
''#define'' DEBUG(sharp,name) sharp##line 0 name<br>
''#define'' DEBUG(sharp,name) sharp##line 0 name<br>
and add this at the right place in your code<br>
and add this at the right place in your code<br>
DEBUG(#,"yourdebugentrypoint");
DEBUG(#,"your filename");


 
This way you can have custom filenames in error messages.
</dd>
}}
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 23:10, 20 November 2023

Hover & click on the images for description

Description

Description:
Returns the preprocessed content of the given file. The preprocessor is C-like, it supports comments using /* */ and PreProcessor Commands. The preprocessor also adds a default debug entrypoint for compiler at the begining of script: #line 1 "aFilename"

The #line keyword can be used in any script that are not preprocess, or with preprocess script with extra macro to protect reserverd sharp character. The format is:
#line <number> "<name>"
followed by new line. <number> could be only positive integer and <name> could be any name. This will be used only if an error occurs in the script. The error will contain the line: File <filename>, line <linenumber>
where <filename> will be the <name> you set and <linenumber> will be <number> + how many lines it is from the #line line. If the error happened on the line right under #line it will add 0 to <number>, if on second line, it will add 1 etc.

It is possible to use more than one #line keywords, but it seems having just one at the top for little script is enough to pinpoint position of the error easily.
If the file you are loading is not prepared using UTF-8 encoding and contains some characters with codes > 127, they might convert incorrectly
Groups:
System

Syntax

Syntax:
preprocessFileLineNumbers fileName
Parameters:
fileName: String - path to the file
Return Value:
String - file content containing #line 1 "aFilename"

Examples

Example 1:
_string = preprocessFileLineNumbers "A3\ui_f\scripts\IGUI\RscUnitInfo.sqf"
Result is:
#line 1 "A3\ui_f\scripts\IGUI\RscUnitInfo.sqf"
disableserialization;
........

Additional Information

See also:
fileExists preprocessFile loadFile Function SQF Syntax call spawn execVM PreProcessor Commands

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
Killzone_Kid - c
Posted on Dec 17, 2013 - 13:44 (UTC)
The main difference between preprocessFile and preprocessFileLineNumbers is that the latter adds #line keyword to the target file, which allows to log the __LINE__ error happened at and the __FILE__ error happened in.
PreprocessFile.jpg
code34 - c
Posted on Nov 04, 2017 - 10:16 (UTC)
The #line directive get's removed from the output.
So to add a custom #line directive before while using preprocessFileLineNumbers, you have to use a preprocessor macro like this:
#define DEBUG(sharp,name) sharp##line 0 name
and add this at the right place in your code
DEBUG(#,"your filename"); This way you can have custom filenames in error messages.