很难想象,居然能找不到一篇比较好的介绍 realpath 的文章。
- 功能简述: 将路径转为绝对路径。
- 函数原型: char * realpath (const char *restrict name, char *restrict resolved)
○ name:原始路径。
○ resolved:存放规范化路径的地址。可以为 null(含义在下面解释)。
○ 返回值:正常情况和resolved是同一个指针。不正常呢(见下面解释)。 - 头文件: stdlib.h
注意,realpath 并不是标准C函数,而是 POSIX 函数,所以你不能在 cppreference.com 这类网站找到使用说明。应该去 gnu 的 glibc 文档中找。
使用方法
很简单,第一个参数指向的路径经过格式化会被复制到第二个参数指向的内存。
最常见的用法:
#include <stdio.h>
#include <stdlib.h>
#include <limits.h>
int main()
{
char *rpath = "./../";
char apath[PATH_MAX + 1];
char *ret = realpath(rpath, apath);
printf("ret = %s\n", ret);
printf("apath = %s\n", apath);
return 0;
}
打印:
ret = /home/cyd/my-github
apath = /home/cyd/my-github
null
前面提到, resolved 参数可以为 null。当它为 null 时等同于函数canonicalize_file_name
,返回值指向函数内动态申请的内存空间,所以要记得 free。
你可能会认为 canonicalize_file_name 这么容易忘记 free 导致内存泄漏,谁会用呢?
事实上,如果传入的第二参数 resolved 非 null 指针,一定要保证有足够的空间存放格式化的地址。一般 Linux/Unix 系统会在limits.h
头文件中定义PATH_MAX
宏,表示路径名的最大长度。但是有的系统可能会没有这个定义,那你就不能使用第二个参数非 null 的 realpath 函数了,因为很容易导致越界。
另外还有一种情况,传入的第一个参数(路径字符串)可能是实际不存在的地址,realpath 函数依然会按照当前工作目录计算绝对路径,存放在第二个参数指向的内存空间。但是,返回值就为 null 了,并且将 errno 置为 EACCES(返回路径不可读)或者 ENOENT(返回路径不存在)
#include <stdio.h>
#include <stdlib.h>
#include <limits.h>
#include <errno.h>
int main()
{
char *rpath = "./../a";
char apath[PATH_MAX + 1];
char *ret = realpath(rpath, apath);
printf("ret = %s\n", ret);
printf("apath = %s\n", apath);
printf("errno = %s\n", errno == EACCES ? "EACCES" :
errno == ENOENT ? "ENOENT" :
"??");
return 0;
}
打印
ret = (null)
apath = /home/cyd/my-github/a
errno = ENOENT
上面提到 canonicalize_file_name (name) 等同于 realpath(name, null),特点就是会自动申请动态内存。