在 C++ 中实现 realpath() 函数

函数 realpath() 首次记录在 POSIX 1997 和 POSIX 2008 中,作为在目录中查找文件绝对路径的函数。

本文解释了函数 realpath() 在 C++ 中的实现。 可以实现到系统中,使用C++查找文件的绝对路径。


在 C++ 中实现 realpath() 函数

C++ 中 realpath() 的主要用途是在解析文件的所有符号链接时查找文件的路径名。

在我们讨论 realpath() 在 C++ 中的实现之前,这里有一些需要知道的基本概念:

  • 符号链接 :符号链接指向它的目标文件,但它不同于快捷方式,因为计算机将符号链接视为一个独立的文件,而不是指向目标文件的链接。 它充当一种文件类型,在访问时将用户带到原始文件所在的位置,对符号链接所做的任何更改也会反映在原始文件中。
  • 绝对路径 :当一个文件的路径写到它的根目录时,如 \usr\bin\main,它被称为它的绝对路径。
  • 相对路径 :如果当前工作目录设置为 usr\bin,那么绝对路径为 /usr/bin/main 的文件可以简单的引用为main。 例如,如果工作目录是 /usr/ast,UNIX 命令:cp /usr/bin/main /usr/bin/main.bak 和命令:cp mailbox mailbox.bak 完成相同的操作。

如果提供的值是相对名称,则 C++ 中函数 realpath() 找到的路径名不一定是绝对路径名,但这还取决于是否使用链接值的绝对名称遍历任何符号链接。 如果是,则输出是绝对名称。


在 C++ 中使用 realpath() 函数查找绝对路径

让我们创建一个程序,使用 C++ 中的 realpath() 查找文件的绝对路径。 本示例在Linux下进行演示(在windows下,分隔符为\)。

  1. 在任何扩展名为 .cpp 的 Linux 发行版中打开文本编辑器。
  2. 该程序有五个导入文件:用于包含 PATH_MAX 子函数的 limits.h、用于输入输出函数的 stdio、用于字符串函数的 stdlib、string、用于错误情况的 cerrno。
  3. 在 main 函数内部,创建了一个变量——一个大小设置为 PATH_MAX 的字符数组 buffer[]。 使用 PATH_MAX 是存储路径名而不是仅仅猜测的更好做法。
  4. C++ 中的 realpath() 有两个参数:文件名和解析名。 它返回指向已解析名称的指针; 否则,返回一个错误标志。
    char *path = realpath("test.py", buffer);
    
  5. 如果 C++ 中的函数 realpath() 成功返回已解析的名称,则会打印变量缓冲区中的值。
    if (path) {
     printf("Absolute Path = %s.\n", buffer);
    }
    
  6. 如果 realpath() 函数返回空指针,程序会使用 errno 函数引发错误标志。
    char* errStr = strerror(errno);
    

    errno 函数是 cerrno 库的一个成员函数。 它返回一个数字错误代码,但使用函数 strerror 将其转换为相应的字符串值:char* errStr = strerror(errno)。

  7. perror 向 stder 打印一条错误消息。 该函数首先打印大括号内提供的文本,然后是错误消息。
    perror("realpath");
    
  8. 最后,程序使用 else 块中的 EXIT_FAILURE 终止代码退出。
    exit(EXIT_FAILURE);
    

完整代码:

#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <cerrno>


int main(void) {
    char buffer[PATH_MAX];
    char *path = realpath("test.py", buffer);
    if (path) { // or: if (path != NULL)
        printf("Absolute Path = %s.\n", buffer);
    } else {
        char* errStr = strerror(errno);
        printf("String Error: %s\n", errStr);

        perror("realpath");
        exit(EXIT_FAILURE);
    }
    return 0;
}

汇编:

由于代码是在 Linux 中编写的,因此必须使用终端进行编译。 使用适当的名称(例如:C-realpath)和 .cpp 扩展名保存其中编写代码的文本文件。

该文件将使用 gcc 编译器编译,并创建一个新的应用程序来运行代码。

使用以下语法:

gcc -o realpath2 C-realpath.cpp

除非出现某些错误,否则上述语法将成功编译代码。 编译后,编译器会为我们的代码创建一个输出应用程序 – realpath2。

要运行该应用程序,请键入语法:

./realpath2

输出结果:

jay@jay-virtual-machine:~$ gcc -o realpath2 C-realpath.cpp
jay@jay-virtual-machine:~$ ./realpath2
Absolute Path = /home/jay/test.py.

由于文件 test.py 存在于系统中,因此程序会打印其绝对路径。

如果为文件提供的名称不正确,或者文件丢失,应用程序会打印错误代码:

jay@jay-virtual-machine:~$ ./realpath2
String Error: No such file or directory
realpath: No such file or directory

使用一行命令在 C++ 中使用 realpath() 函数查找绝对路径

C++中的函数 realpath() 在Linux中也可以通过单行命令来实现。 这使程序员无需创建文本文件来编写代码并单独编译它们。

要编译代码,请在终端内编写以下语法:

gcc -o realpath -x c - <<< $'#include<stdlib.h>\n#include<stdio.h>\nint main(int c,char**v){puts(realpath(v[1],0));}'

代码的作用:

  1. gcc -o realpath 使用 gcc 编译器创建一个输出应用程序 realpath。
  2. 该代码有两个库包:stdlib 和 stdio。
  3. 在 main 方法中,创建了两个变量:一个整型变量 c 和一个指针 v。
  4. puts(realpath(v[1],0)) 返回从 realpath() 函数返回的字符串文字。

需要向输出应用程序 realpath 提供文件名或路径以生成输出。 在这个例子中,文件系统中的一个文件夹被传递给应用程序,它返回文件的绝对路径。

输出:

jay@jay-virtual-machine:~$ ./realpath snap
/home/jay/snap

由于代码中没有错误异常,如果输入的是丢失的文件,则会抛出错误:

jay@jay-virtual-machine:~$ ./realpath vid
Segmentation fault (core dumped)

总结

本文介绍如何在 C++ 中实现函数 realpath() 来查找文件的绝对路径。 看完文章,读者可以在C++中使用 realpath() 导出文件的绝对路径。