Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

canonicalize_file_name-返回规范化的绝对​​路径名

语法

＃定义_GNU_SOURCE / 参见feature_test_macros(7)/
＃包括

char * canonicalize_file_name(const char * path);

说明

canonicalize_file_name()函数返回一个以null结尾的字符串，其中包含与path对应的规范化绝对路径名。在返回的字符串中，符号链接也被解析。和..路径名组件。连续的斜杠(/)字符将替换为一个斜杠。

返回的字符串由canonicalize_file_name()动态分配，并且在不再需要时，调用方应使用free(3)对其进行分配。

调用canonicalize_file_name(path)等效于该调用：

realpath(路径，NULL);

返回值

成功时，canonicalize_file_name()返回以空值结尾的字符串。发生错误时(例如，路径名组件不可读或不存在)，canonicalize_file_name()返回NULL并设置errno来指示错误。

错误说明

参见realpath(3)。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

此函数是GNU扩展。

另外参见

readlink(2)，realpath(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。