Namespaces
Variants

std::filesystem::directory_entry:: exists

From cppreference.net
C++
Filesystem library
Classes
Functions
File types
std::filesystem::directory_entry
Member functions
Modifiers
Observers
directory_entry::exists
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20) (C++20)
Non-member functions
bool exists ( ) const ;
(1) (seit C++17)
bool exists ( std:: error_code & ec ) const noexcept ;
(2) (seit C++17)

Prüft, ob das referenzierte Objekt existiert. Effektiv gibt es zurück:

1) std:: filesystem :: exists ( status ( ) ) ,
2) std:: filesystem :: exists ( status ( ec ) ) .

Beachten Sie, dass status() symbolischen Links zu ihren Zielen folgt.

Inhaltsverzeichnis

Parameter

ec - Out-Parameter für Fehlerberichterstattung in der nicht-werfenden Überladung

Rückgabewert

true wenn das referenzierte Dateisystemobjekt existiert.

Ausnahmen

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

1) Wirft std::filesystem::filesystem_error bei zugrundeliegenden OS-API-Fehlern, konstruiert mit p als erstem Pfadargument und dem OS-Fehlercode als Fehlercodeargument.
2) Setzt einen std:: error_code & Parameter auf den OS-API-Fehlercode, wenn ein OS-API-Aufruf fehlschlägt, und führt ec. clear ( ) aus, wenn keine Fehler auftreten.

Beispiel

Diesen Code ausführen 
#include <filesystem>
#include <iostream>
int main()
{
    for (auto const str:
    {
        "/usr/bin/cat",
        "/usr/bin/mouse",
        "/usr/bin/python",
        "/usr/bin/bison",
        "/usr/bin/yacc",
        "/usr/bin/c++",
    })
    {
        std::filesystem::directory_entry entry{str};
        std::cout << "directory entry " << entry
                  << (entry.exists() ? " exists\n" : " does not exist\n");
    }
}

Mögliche Ausgabe: 

// Output on a POSIX system:
directory entry "/usr/bin/cat" exist
directory entry "/usr/bin/mouse" does not exist
directory entry "/usr/bin/python" exists
directory entry "/usr/bin/bison" exists
directory entry "/usr/bin/yacc" does not exist
directory entry "/usr/bin/c++" exists

Siehe auch

(C++17)
prüft, ob der Pfad auf ein existierendes Dateisystemobjekt verweist
(Funktion)