语法：

file_find_first(mask, attr);

返回： String（字符串）

描述

此函数将返回满足掩码和属性的第一个文件的名称。如果不存在这样的文件，则返回空字符串。掩码可以包含一个路径，并且可以包含通配符，例如 “c:\temp\*.doc”。这些属性提供了你想要查看的其他文件，因此在满足掩码时始终会返回普通文件。你可以添加以下常量来查看所需的文件类型（如果你不想添加任何属性，请使用 0）：

• fa_readonly - 只读文件
• fa_hidden - 隐藏文件
• fa_sysfile - 系统文件
• fa_volumeid - 卷标识文件
• fa_directory - 目录
• fa_archive - 归档文件

警告！ 此函数可能无法正常工作！ 因为 GameMaker Studio 2 被沙盒化。有关详细信息，请参阅 文件系统限制 部分。

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

例如：

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

这将检查指定的目录是否存在，如果存在，则去那里并返回找到的第一个 “只读” doc 文件。