std::filesystem:: equivalent

Überprüft, ob die Pfade p1 und p2 zur selben Dateisystem-Entität aufgelöst werden.

Wenn entweder p1 oder p2 nicht existiert, wird ein Fehler gemeldet.

Die nicht-werfende Überladung gibt bei Fehlern false zurück.

Parameter

Rückgabewert

true wenn p1 und p2 auf dieselbe Datei oder dasselbe Verzeichnis verweisen und ihr Dateistatus identisch ist. false andernfalls.

Exceptions

Jede Überladung, die nicht als noexcept gekennzeichnet ist, kann std::bad_alloc auslösen, wenn die Speicherallokation fehlschlägt.

Hinweise

Zwei Pfade werden als identische Dateisystem-Entitäten betrachtet, wenn die beiden Kandidaten-Entitäten, auf die die Pfade verweisen, sich auf demselben Gerät an derselben Position befinden. Für POSIX bedeutet dies, dass die st_dev - und st_ino -Member ihrer POSIX stat -Struktur , ermittelt wie durch POSIX stat() , gleich sind.

Insbesondere sind alle Hardlinks für dieselbe Datei oder dasselbe Verzeichnis äquivalent, und ein Symlink und sein Ziel auf demselben Dateisystem sind äquivalent.

Beispiel

#include <cstdint>
#include <filesystem>
#include <iostream>
namespace fs = std::filesystem;
int main()
{
    // hard link equivalency
    fs::path p1 = ".";
    fs::path p2 = fs::current_path();
    if (fs::equivalent(p1, p2))
        std::cout << p1 << " is equivalent to " << p2 << '\n';
    // symlink equivalency
    for (const fs::path lib : {"/lib/libc.so.6", "/lib/x86_64-linux-gnu/libc.so.6"})
    {
        try
        {
            p2 = lib.parent_path() / fs::read_symlink(lib);
        }
        catch (std::filesystem::filesystem_error const& ex)
        {
            std::cout << ex.what() << '\n';
            continue;
        }
        if (fs::equivalent(lib, p2))
            std::cout << lib << " is equivalent to " << p2 << '\n';
    }
}

"." is equivalent to "/var/tmp/test"
filesystem error: read_symlink: No such file or directory [/lib/libc.so.6]
"/lib/x86_64-linux-gnu/libc.so.6" is equivalent to "/lib/x86_64-linux-gnu/libc-2.23.so"

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch