Returns the name of the first file that satisfies the mask and the attributes.


file_find_first(mask, attr);

Argument Description
mask The mask to use for searching.
attr The specific file attribute to look for.

Returns: String


This function will return the name of the first file that satisfies the mask and the attributes. If no such file exists, then an empty string is returned. The mask can contain a path and can contain wildchars, for example 'C:\temp\*.doc'. The attributes give the additional files you want to see, so the normal files are always returned when they satisfy the mask. You can add up the following constants to see the type of files you want (if you do not wish to add any attributes, use 0):

WARNING! This function may not work as you expect due to GameMaker: Studio being sandboxed! Please see the section on File System Limits for more information.

NOTE: This function will not work at all on the JS target platforms (Windows8, Tizen, and HTML5), and the filter flags will only work on Windows and WinPhone (use 0 for all other platforms).


if directory_exists("\User Content")
   file = file_find_first("\User Content\*.doc", fa_readonly);

This will check to see if the specified directory exists then, if it does, go there and return the first "read only" doc file found.

Back: File System Functions
Next: file_find_next
© Copyright YoYo Games Ltd. 2015 All Rights Reserved