std::experimental::filesystem::absolute, std::experimental::filesystem::system_complete
Von cppreference.com
< cpp | experimental | fs
| Definiert im Header <experimental/filesystem> |
||
| path absolute( const path& p, const path& base = current_path() ); |
(1) | (Dateisystem-TS) |
| path system_complete( const path& p ); path system_complete( const path& p, error_code& ec ); |
(2) | (Dateisystem-TS) |
1) Gibt den absoluten Pfad von p relativ zu base gemäß den folgenden Regeln zurück.
- Wenn p sowohl einen Stamm-Namen als auch ein Stamm-Verzeichnis hat (z.B. "C:\users"), dann wird der Pfad unverändert zurückgegeben.
- Wenn p einen Stamm-Namen hat, dem kein Stamm-Verzeichnis folgt (z.B. "C:text.txt"), dann wird base zwischen dem Stamm-Namen von p und dem Rest von p eingefügt. Formell wird p.root_name() / fs::absolute(base).root_directory() / fs::absolute(base).relative_path() / p.relative_path() zurückgegeben.
- Wenn p keinen Stamm-Namen, aber ein Stamm-Verzeichnis hat (z.B. "/var/tmp/file.txt" auf einem POSIX-System oder "\users\ABC\Document.doc" unter Windows), dann wird der Stamm-Name von base, falls vorhanden, p vorangestellt (auf einem POSIX-System wird p nicht modifiziert, unter Windows wird "\users\ABC\Document.doc" zu "C:\users\ABC\Document.doc"). Formell wird fs::absolute(base).root_name() / p zurückgegeben.
- Wenn p weder einen Stamm-Namen noch ein Stamm-Verzeichnis hat (z.B. "../file.txt"), dann wird der gesamte base p vorangestellt. Formell wird absolute(base) / p zurückgegeben.
2) Ermittelt den absoluten Pfad, der die Datei identifiziert, auf die die OS-Dateiöffnungs-API mit dem Pfadnamen p zugreifen würde. Auf POSIX-Systemen ist dies äquivalent zu (1) mit dem Standard-base (
fs::current_path()). Auf Windows-Systemen hat jedes logische Laufwerk sein eigenes aktuelles Arbeitsverzeichnis. Wenn p nicht bereits absolut ist und eine Stamm-Namenskomponente hat (z.B. "E:filename.txt"), wird das aktuelle Arbeitsverzeichnis dieses Laufwerks verwendet, das möglicherweise durch ein zuvor ausgeführtes Programm festgelegt wurde.Inhalt |
[edit] Parameter
| p | - | zu konvertierender Pfad in absoluter Form |
| base | - | Pfad (nicht notwendigerweise absolut), der als Startpunkt dient |
| ec | - | Ausgabeparameter für die Fehlerberichterstattung in der nicht auslösenden Überladung |
[edit] Rückgabewert
Gibt einen absoluten (wenn auch nicht notwendigerweise kanonischen) Pfad zurück, der durch die Kombination von p und base wie oben beschrieben gebildet wird.
[edit] Ausnahmen
Die Überladung, die keinen Parameter vom Typ error_code& enthält, wirft filesystem_error bei zugrundeliegenden OS-API-Fehlern, konstruiert mit p als erstes Argument, base als zweites Argument und dem OS-Fehlercode als Fehlercode-Argument. std::bad_alloc kann geworfen werden, wenn die Speicherzuweisung fehlschlägt. Die Überladung, die einen Parameter vom Typ error_code& nimmt, setzt diesen auf den OS-API-Fehlercode, wenn ein OS-API-Aufruf fehlschlägt, und führt ec.clear() aus, wenn keine Fehler auftreten. Diese Überladung hatnoexcept-Spezifikation:
noexcept
[edit] Hinweise
Auf Systemen, die Stamm-Namen unterstützen (z.B. Windows), führt der Aufruf von absolute für einen relativen Pfad mit einem Stamm-Namen (z.B. "D:file.txt", wenn der Stamm-Name von base anders ist) in der Regel zu einem nicht existierenden Pfad.
[edit] Beispiel
Führen Sie diesen Code aus
#include <filesystem> #include <iostream> namespace fs = std::experimental::filesystem; int main() { fs::path p = "C:cl.exe"; std::cout << "Current path is " << fs::current_path() << '\n' << "Absolute path for " << p << " is " << fs::absolute(p) << '\n' << "System complete path for " << p << " is " << fs::system_complete(p) << '\n'; }
Mögliche Ausgabe
Current path is "D:/local/ConsoleApplication1" Absolute path for "C:cl.exe" is "C:/local/ConsoleApplication1/cl.exe" System complete path for "C:cl.exe" is "C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\bin\cl.exe"
[edit] Siehe auch
| komponiert einen kanonischen Pfad (Funktion) |
