std::filesystem::exists

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Dateisystem-Bibliothek

Klassen
filesystem::path filesystem::filesystem_error filesystem::directory_entry filesystem::directory_iterator filesystem::recursive_directory_iterator    filesystem::file_status filesystem::space_info	filesystem::file_type filesystem::file_time_type filesystem::perms filesystem::perm_options filesystem::copy_options filesystem::directory_options
Funktionen
filesystem::absolute filesystem::canonicalfilesystem::weakly_canonical filesystem::relativefilesystem::proximate filesystem::copy filesystem::copy_file filesystem::copy_symlink filesystem::create_directory filesystem::create_directories filesystem::create_hard_link filesystem::create_symlink filesystem::create_directory_symlink filesystem::current_path filesystem::temp_directory_path	filesystem::exists filesystem::equivalent filesystem::file_size filesystem::hard_link_count filesystem::last_write_time filesystem::permissions filesystem::read_symlink filesystem::remove filesystem::remove_all filesystem::rename filesystem::resize_file filesystem::space filesystem::status filesystem::symlink_status
Dateitypen
filesystem::is_block_file filesystem::is_character_file filesystem::is_directory filesystem::is_empty filesystem::status_known	filesystem::is_fifo filesystem::is_other filesystem::is_regular_file filesystem::is_socket filesystem::is_symlink

 

Definiert in Header <filesystem>
bool exists( std::filesystem::file_status s ) noexcept;	(1)	(seit C++17)
bool exists( const std::filesystem::path& p );	(2)	(seit C++17)
bool exists( const std::filesystem::path& p, std::error_code& ec ) noexcept;	(3)	(seit C++17)

Prüft, ob der gegebene Dateistatus oder Pfad einer vorhandenen Datei oder einem vorhandenen Verzeichnis entspricht.

1) Äquivalent zu status_known(s) && s.type() != file_type::not_found.

2,3) Sei s ein std::filesystem::file_status, der wie durch status(p) oder status(p, ec) bestimmt wird (symbolische Links werden verfolgt). Gibt exists(s) zurück. Die nicht-werfende Überladung ruft ec.clear() auf, wenn status_known(s).

Parameter

s	-	Dateistatus zum Prüfen
p	-	Zu untersuchender Pfad
ec	-	Ausgabeparameter für die Fehlerberichterstattung in der nicht auslösenden Überladung

Rückgabewert

true, wenn der gegebene Pfad oder Dateistatus einer vorhandenen Datei oder einem vorhandenen Verzeichnis entspricht, false andernfalls.

Ausnahmen

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

2) Wirft std::filesystem::filesystem_error bei zugrunde liegenden Betriebssystem-API-Fehlern, konstruiert mit p als erstes Pfadargument und dem Betriebssystem-Fehlercode als Fehlercodeargument.

3) Setzt einen std::error_code&-Parameter auf den Betriebssystem-API-Fehlercode, wenn ein Betriebssystem-API-Aufruf fehlschlägt, und ruft ec.clear() auf, wenn keine Fehler auftreten.

Es wird keine Dateisystemausnahme ausgelöst, wenn das Objekt nicht existiert (verwenden Sie den Rückgabewert).

Hinweise

Die von dieser Funktion bereitgestellten Informationen werden normalerweise auch als Nebenprodukt der Verzeichnisiteration bereitgestellt. Während der Verzeichnisiteration ist der Aufruf von exists(*iterator) weniger effizient als exists(iterator->status()).

Beispiel

Führen Sie diesen Code aus

#include <cstdint>
#include <filesystem>
#include <fstream>
#include <iostream>
namespace fs = std::filesystem;
 
void demo_exists(const fs::path& p, fs::file_status s = fs::file_status{})
{
    std::cout << p;
    if (fs::status_known(s) ? fs::exists(s) : fs::exists(p))
        std::cout << " exists\n";
    else
        std::cout << " does not exist\n";
}
 
int main()
{
    const fs::path sandbox{"sandbox"};
    fs::create_directory(sandbox);
    std::ofstream{sandbox/"file"}; // create regular file
    fs::create_symlink("non-existing", sandbox/"symlink");
 
    demo_exists(sandbox);
 
    for (const auto& entry : fs::directory_iterator(sandbox))
        demo_exists(entry, entry.status()); // use cached status from directory entry
 
    fs::remove_all(sandbox);
}

Ausgabe

"sandbox" exists
"sandbox/symlink" does not exist
"sandbox/file" exists

Siehe auch

statussymlink_status (C++17)(C++17)	ermittelt Dateiattribute ermittelt Dateiattribute, wobei das Ziel des symbolischen Links geprüft wird (Funktion)
file_status (C++17)	repräsentiert Dateityp und Berechtigungen (Klasse)
exists	prüft, ob der Verzeichniseintrag auf ein existierendes Dateisystemobjekt verweist (öffentliche Elementfunktion von std::filesystem::directory_entry)