std::filesystem::directory_entry:: refresh
|
void
refresh
(
)
;
|
(1) | (seit C++17) |
|
void
refresh
(
std::
error_code
&
ec
)
noexcept
;
|
(2) | (seit C++17) |
Untersucht das Dateisystemobjekt, auf das dieser Verzeichniseintrag verweist, und speichert seine Attribute für den Abruf mit
status
,
exists
,
is_regular_file
und anderen Statusabfragefunktionen.
Wenn ein Fehler auftritt, ist der Wert aller zwischengespeicherten Attribute nicht spezifiziert.
Inhaltsverzeichnis |
Parameter
| ec | - | Out-Parameter für Fehlerberichterstattung in der nicht-werfenden Überladung |
Rückgabewert
(keine)
Ausnahmen
Jede Überladung, die nicht als
noexcept
gekennzeichnet ist, kann
std::bad_alloc
auslösen, wenn die Speicherallokation fehlschlägt.
Hinweise
Viele Low-Level-Betriebssystem-APIs für das Durchlaufen von Verzeichnissen rufen Dateiattribute zusammen mit dem nächsten Verzeichniseintrag ab. Die Konstruktoren und die nicht-konstanten Memberfunktionen von std::filesystem::directory_iterator speichern diese Attribute, falls vorhanden, im referenzierten std::filesystem::directory_entry ohne Aufruf von directory_entry::refresh , was es ermöglicht, die Attribute der Verzeichniseinträge während der Iteration zu überprüfen, ohne zusätzliche Systemaufrufe durchzuführen.
Beispiel
|
Dieser Abschnitt ist unvollständig
Grund: Kein Beispiel |
Siehe auch
|
Status der durch diesen Directory-Eintrag bezeichneten Datei;
Status der durch diesen Directory-Eintrag bezeichneten Datei/Symlink (öffentliche Elementfunktion) |
|
|
prüft, ob der Directory-Eintrag auf ein existierendes Dateisystemobjekt verweist
(öffentliche Elementfunktion) |
|
|
prüft, ob der Directory-Eintrag auf ein Blockgerät verweist
(öffentliche Elementfunktion) |
|
|
prüft, ob der Directory-Eintrag auf ein Zeichengerät verweist
(öffentliche Elementfunktion) |
|
|
prüft, ob der Directory-Eintrag auf ein Verzeichnis verweist
(öffentliche Elementfunktion) |
|
|
prüft, ob der Directory-Eintrag auf eine benannte Pipe verweist
(öffentliche Elementfunktion) |
|
|
prüft, ob der Directory-Eintrag auf eine
andere
Datei verweist
(öffentliche Elementfunktion) |
|
|
prüft, ob der Directory-Eintrag auf eine reguläre Datei verweist
(öffentliche Elementfunktion) |
|
|
prüft, ob der Directory-Eintrag auf einen benannten IPC-Socket verweist
(öffentliche Elementfunktion) |
|
|
prüft, ob der Directory-Eintrag auf einen symbolischen Link verweist
(öffentliche Elementfunktion) |
|
|
gibt die Größe der Datei zurück, auf die der Directory-Eintrag verweist
(öffentliche Elementfunktion) |
|
|
gibt die Anzahl der Hardlinks zurück, die auf die Datei verweisen, auf die der Directory-Eintrag verweist
(öffentliche Elementfunktion) |
|
|
ruft den Zeitpunkt der letzten Datenänderung der Datei ab, auf die der Directory-Eintrag verweist
(öffentliche Elementfunktion) |