preprocessFile: Difference between revisions

Revision as of 17:38, 25 July 2014

Hover & click on the images for description

Description:: Reads and processes the content of the specified file. Preprocessor is C-like, supports comments using // or /* and */ and macros defined with #define.
Due to the hard-drive access this command executes (and the lack of caching) this command should not be used in time-critical script loops.
Groups:: Uncategorised

Example 1:

_content=preprocessFile "myFunction.sqf"

See also:: preprocessFileLineNumbers loadFile Function SQF syntax call spawn execVM PreProcessor Commands

: 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 on March 4, 2008
Alef: File path is always relative to mission directory. If script dir\a.sqf includes dir\b.sqf, use "dir\b.sqf" and not "b.sqf".; Posted on July 8, 2011
kju: Use preprocessFileLineNumbers instead as it provides more context information on error.; Posted on December 17, 2013
Killzone_Kid: The main difference between preprocessFile and preprocessFileLineNumbers is that the latter adds #line directive to the target file, which allows to log the __LINE__ error happened at and the __FILE__ error happened in.

@@ Line 56: / Line 56: @@
 <!-- CONTINUE Notes -->
-<dl class="command_description">
-<dd class="notedate">Posted on July 25, 2014 - 16:35 (UTC)</dd>
-<dt class="note">[[User:BrotherhoodOfHam|BrotherhoodOfHam]]</dt>
-<dd class="note">
-.
 </dd>
 </dl>
 <!-- DISCONTINUE Notes -->
-Essentially what the preprocessFile command does is it refers to the contents of a file as a string:<br/>
-Example 1:
-<br/>boop.html:
-<code><t align = 'center' valign = 'middle' shadow = '0' size = '2'>structured text</t></code>
-init.sqf:
-<code>_text = [[parseText]] preprocessFile "boop.html";
-hint _text;
-</code>
-This is especially useful for long strings, and it works on files with any file extension as long as they can be edited with a text editor.
-<br/>
-Example 2:
-<br/>
-init.sqf: <br/>
-<code>hint preprocessFile "description.ext";
-[[copyToClipboard]] preprocessFile "mission.sqm";
-</code>
-The above is all valid. However, using *.jpg or any other files saved in an image format is not possible.