Erlang 20参考手册

stdlib

filelib

模块

filelib

模块摘要

文件实用程序，例如文件名的通配符匹配。

描述

此模块包含的实用程序级别高于file模块。

该模块不支持“原始”文件名（即名称不符合预期编码的文件）。这些文件被本模块中的功能忽略。

有关原始文件名的详细信息，请参阅file模块。

数据类型

filename() = file:name()

dirname() =filename()

dirname_all() =filename_all()

filename_all() = file:name_all()

find_file_rule() =

{ObjDirSuffix :: string(), SrcDirSuffix :: string()}

find_source_rule() =

{ObjExtension :: string(),

SrcExtension :: string(),

[find_file_rule()]}

输出

ensure_dir(Name) -> ok | {error, Reason}

类型

确保指定文件或目录名的所有父目录Name存在，并在必要时尝试创建它们。

如果所有父目录已经存在或可以创建，则返回ok。如果某个父目录不存在并且无法创建，则返回{error，Reason}。

file_size(Filename) -> integer() >= 0

类型

返回指定文件的大小。

fold_files(Dir, RegExp, Recursive, Fun, AccIn) -> AccOut

类型

折叠函数有趣于目录Dir中与正则表达式RegExp匹配的所有（常规）文件F（有关允许的正则表达式的描述，请参阅re模块）。如果递归为真，则处理Dir的所有子目录。正则表达式匹配只在没有目录部分的文件名上完成。

如果Unicode文件名转换生效且文件系统是透明的，则可能遇到不能被解释为Unicode的文件名，在这种情况下，fun()必须准备好处理原始文件名（即二进制文件）。如果正则表达式包含的代码点大于255，则它不匹配不符合预期字符编码的文件名（即，不以有效的UTF-8编码）。

有关原始文件名的详细信息，请参阅file模块。

is_dir(Name) -> boolean()

类型

如果Name引用一个目录，则返回true，否则返回false。

is_file(Name) -> boolean()

类型

如果Name引用文件或目录，则返回true，否则返回false。

is_regular(Name) -> boolean()

类型

如果Name引用（常规）文件，则返回true，否则返回false。

last_modified(Name) -> file:date_time() | 0

类型

返回指定文件或目录上次修改的日期和时间，或者文件不存在时返回0

wildcard(Wildcard) -> file:filename()

类型

返回与Unix样式通配符字符串匹配的所有文件的列表Wildcard。

通配符字符串看起来像一个普通文件名，但以下“通配符”是以一种特殊的方式解释的：

？

匹配一个字符。

匹配任意数量的字符，直到文件名末尾、下一个点或下一个斜杠。

两相邻*作为单一模式使用，匹配所有文件和零或多个目录和子目录。

Character1,Character2,...

匹配列出的任何字符。由连字符分隔的两个字符匹配一系列字符。示例：[A-Z]匹配任何大写字母。

{项目...}

交替。匹配其中一个替代方案。

其他字符代表自己。只有在相同位置具有完全相同字符的文件名匹配。匹配区分大小写，例如“a”与“A”不匹配。

请注意，允许多个“*”字符（如在Unix通配符中，但与Windows / DOS通配符相反）。

例子：

下面的示例假设当前目录是Erlang/OTP安装的顶部。

找到所有.beam所有应用程序中的文件，请使用以下行：

filelib:wildcard("lib/*/ebin/*.beam").

找到.erl或.hrl在所有应用中src目录，请使用下列任何一行：

filelib:wildcard("lib/*/src/*.?rl")

filelib:wildcard("lib/*/src/*.{erl,hrl}")

找到所有.hrl文件在src或include目录：

filelib:wildcard("lib/*/{src,include}/*.hrl").

找到所有.erl或.hrl文件src或include目录：

filelib:wildcard("lib/*/{src,include}/*.{erl,hrl}")

找到所有.erl或.hrl任何子目录中的文件：

filelib:wildcard("lib/**/*.{erl,hrl}")

通配符（通配符，Cwd） - > file:filename()