fileExists: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Created page with "{{Command|Comments= | arma3dev |Game name= |2.01|Game version= |gr1= Strings |GROUP1= | Checks if file on given path exists. Uses same path resolve code as loadFile. |...")
 
m (Text replacement - "{{Feature|Informative|" to "{{Feature|informative|")
 
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command


| arma3dev |Game name=
|game1= arma3
|version1= 2.02


|2.01|Game version=
|gr1= Program Flow


|gr1= Strings |GROUP1=
|descr= Checks if file on given path exists. Uses same path resolve code as [[loadFile]].
{{Feature|informative|Absolute paths are not supported, such as those generated using [[getMissionPath]]. Attempting to check an absolute path will result in this error in [[RPT]] logs:
{{hl|Invalid path (only relative paths supported): 'C:\...'}}
}}


| Checks if file on given path exists. Uses same path resolve code as [[loadFile]]. |DESCRIPTION=
|s1= [[fileExists]] path


| [[fileExists]] path |SYNTAX=
|p1= path: [[String]] - path to file


|p1= path: [[String]] - Path to file |PARAMETER1=
|r1= [[Boolean]] - [[true]] if it exists, otherwise [[false]]


| [[Boolean]] - [[True]] if it exists, otherwise [[false]]|RETURNVALUE=
|x1= <sqf>fileExists "\a3\mySuperPath\bestFileEver.paa"; // returns false</sqf>
 
|x1= <code>[[fileExists]] "\a3\mySuperPath\bestFileEver.paa"; {{cc|Returns [[false]]}}</code> |EXAMPLE1=


|x2= <code>[[private]] _path [[a = b|=]] "a3\functions_f_mp_mark\revive\_addaction_revive.inc";
|x2= <sqf>
private _path = "a3\functions_f_mp_mark\revive\_addaction_revive.inc";
if (fileExists _path) then { loadFile _path } else { diag_log format ["File (%1) does not exist!", _path] };
</sqf>


[[if]] ([[fileExists]] _path) [[then]] {[[loadFile]] _path} [[else]] {[[diag_log]] [[format]] ["File (%1) does not exist!",_path]};</code>
|x3= <sqf>
// Sometimes it might be better to check if a file exists instead of checking if path is empty ("")
private _class = "ModuleObjectiveRaceFinish_F";
private _picture = getText (configFile >> "CfgVehicles" >> _class >> "editorPreview");
if !(fileExists _picture) then { _picture = getText (configFile >> "CfgVehicles" >> _class >> "portrait") };
if !(fileExists _picture) then { _picture = getText (configFile >> "CfgVehicles" >> _class >> "icon") };
if !(fileExists _picture) then { _picture = getText (configFile >> "CfgVehicles" >> _class >> "picture") };
if !(fileExists _picture) then { systemChat "No valid picture found!" } else { systemChat _picture };
</sqf>


| [[loadFile]] |SEEALSO=
|seealso= [[loadFile]] [[preprocessFile]] [[preprocessFileLineNumbers]]
}}
 
{{Note
|user= Leopard20
|timestamp= 20220101162930
|text= Returns [[true]] for empty strings: <sqf inline>fileExists ""; // true</sqf>
}}
}}

Latest revision as of 00:24, 2 February 2024

Arma 3 logo black.png2.02
Hover & click on the images for description

Description

Description:
Checks if file on given path exists. Uses same path resolve code as loadFile.
ⓘ
Absolute paths are not supported, such as those generated using getMissionPath. Attempting to check an absolute path will result in this error in RPT logs: Invalid path (only relative paths supported): 'C:\...'
Groups:
Program Flow

Syntax

Syntax:
fileExists path
Parameters:
path: String - path to file
Return Value:
Boolean - true if it exists, otherwise false

Examples

Example 1:
fileExists "\a3\mySuperPath\bestFileEver.paa"; // returns false
Example 2:
private _path = "a3\functions_f_mp_mark\revive\_addaction_revive.inc"; if (fileExists _path) then { loadFile _path } else { diag_log format ["File (%1) does not exist!", _path] };
Example 3:
// Sometimes it might be better to check if a file exists instead of checking if path is empty ("") private _class = "ModuleObjectiveRaceFinish_F"; private _picture = getText (configFile >> "CfgVehicles" >> _class >> "editorPreview"); if !(fileExists _picture) then { _picture = getText (configFile >> "CfgVehicles" >> _class >> "portrait") }; if !(fileExists _picture) then { _picture = getText (configFile >> "CfgVehicles" >> _class >> "icon") }; if !(fileExists _picture) then { _picture = getText (configFile >> "CfgVehicles" >> _class >> "picture") }; if !(fileExists _picture) then { systemChat "No valid picture found!" } else { systemChat _picture };

Additional Information

See also:
loadFile preprocessFile preprocessFileLineNumbers

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
Leopard20 - c
Posted on Jan 01, 2022 - 16:29 (UTC)
Returns true for empty strings: fileExists ""; // true
Retrieved from "https://community.bistudio.com/wiki?title=fileExists&oldid=352073"