std::filesystem:: is_character_file
|
Definiert im Header
<filesystem>
|
||
|
bool
is_character_file
(
std::
filesystem
::
file_status
s
)
noexcept
;
|
(1) | (seit C++17) |
|
bool
is_character_file
(
const
std::
filesystem
::
path
&
p
)
;
|
(2) | (seit C++17) |
|
bool
is_character_file
(
const
std::
filesystem
::
path
&
p,
std::
error_code
&
ec
)
noexcept
;
|
(3) | (seit C++17) |
Prüft, ob der angegebene Dateistatus oder Pfad einer zeichenorientierten Spezialdatei entspricht, wie von POSIX S_ISCHR bestimmt. Beispiele für zeichenorientierte Spezialdateien sind Zeichengeräte wie / dev / null , / dev / tty , / dev / audio oder / dev / nvram unter Linux.
Inhaltsverzeichnis |
Parameter
| s | - | zu prüfender Dateistatus |
| p | - | zu untersuchender Pfad |
| ec | - | Ausgabeparameter für Fehlerberichterstattung in der nicht-werfenden Überladung |
Rückgabewert
true wenn die durch p angegebene Datei oder der durch s angegebene Typ auf ein Zeichengerät verweist, false andernfalls. Die nicht-werfende Überladung gibt false zurück, wenn ein Fehler auftritt.
Exceptions
Jede Überladung, die nicht als
noexcept
gekennzeichnet ist, kann
std::bad_alloc
auslösen, wenn die Speicherzuweisung fehlschlägt.
Beispiel
#include <cstdio> #include <cstring> #include <filesystem> #include <fstream> #include <iostream> #include <sys/socket.h> #include <sys/stat.h> #include <sys/un.h> #include <unistd.h> namespace fs = std::filesystem; void demo_status(const fs::path& p, fs::file_status s) { std::cout << p; // alternative: switch(s.type()) { case fs::file_type::regular: ...} if (fs::is_regular_file(s)) std::cout << " ist eine reguläre Datei\n"; if (fs::is_directory(s)) std::cout << " ist ein Verzeichnis\n"; if (fs::is_block_file(s)) std::cout << " ist ein Blockgerät\n"; if (fs::is_character_file(s)) std::cout << " ist ein Zeichengerät\n"; if (fs::is_fifo(s)) std::cout << " ist eine benannte IPC-Pipe\n"; if (fs::is_socket(s)) std::cout << " ist ein benannter IPC-Socket\n"; if (fs::is_symlink(s)) std::cout << " ist ein Symlink\n"; if (!fs::exists(s)) std::cout << " existiert nicht\n"; } int main() { // Erstellen verschiedener Dateitypen fs::create_directory("sandbox"); fs::create_directory("sandbox/dir"); std::ofstream{"sandbox/file"}; // reguläre Datei erstellen fs::create_symlink("file", "sandbox/symlink"); mkfifo("sandbox/pipe", 0644); sockaddr_un addr; addr.sun_family = AF_UNIX; std::strcpy(addr.sun_path, "sandbox/sock"); int fd = socket(PF_UNIX, SOCK_STREAM, 0); bind(fd, reinterpret_cast<sockaddr*>(&addr), sizeof addr); // Demonstration verschiedener Statusabfragen for (auto it{fs::directory_iterator("sandbox")}; it != fs::directory_iterator(); ++it) demo_status(*it, it->symlink_status()); // verwendung des zwischengespeicherten Status aus dem Verzeichniseintrag demo_status("/dev/null", fs::status("/dev/null")); // direkte Statusaufrufe demo_status("/dev/sda", fs::status("/dev/sda")); demo_status("sandbox/no", fs::status("/sandbox/no")); // Bereinigung (bevorzugt std::unique_ptr-basierte benutzerdefinierte Löscher) close(fd); fs::remove_all("sandbox"); }
Mögliche Ausgabe:
"sandbox/file" ist eine reguläre Datei "sandbox/dir" ist ein Verzeichnis "sandbox/pipe" ist eine benannte IPC-Pipe "sandbox/sock" ist ein benannter IPC-Socket "sandbox/symlink" ist ein Symlink "/dev/null" ist ein Zeichengerät "/dev/sda" ist ein Blockgerät "sandbox/no" existiert nicht
Siehe auch
|
(C++17)
(C++17)
|
Bestimmt Dateiattribute
Bestimmt Dateiattribute, überprüft das Symlink-Ziel (Funktion) |
|
(C++17)
|
Repräsentiert Dateityp und Berechtigungen
(Klasse) |
|
(C++17)
|
Überprüft, ob der Dateistatus bekannt ist
(Funktion) |
|
(C++17)
|
Überprüft, ob der angegebene Pfad auf ein Blockgerät verweist
(Funktion) |
|
(C++17)
|
Überprüft, ob der angegebene Pfad auf ein Verzeichnis verweist
(Funktion) |
|
(C++17)
|
Überprüft, ob der angegebene Pfad auf eine benannte Pipe verweist
(Funktion) |
|
(C++17)
|
Überprüft, ob das Argument auf eine
andere
Datei verweist
(Funktion) |
|
(C++17)
|
Überprüft, ob das Argument auf eine reguläre Datei verweist
(Funktion) |
|
(C++17)
|
Überprüft, ob das Argument auf einen benannten IPC-Socket verweist
(Funktion) |
|
(C++17)
|
Überprüft, ob das Argument auf einen symbolischen Link verweist
(Funktion) |
|
(C++17)
|
Überprüft, ob der Pfad auf ein existierendes Dateisystemobjekt verweist
(Funktion) |
|
Überprüft, ob der Verzeichniseintrag auf ein Zeichengerät verweist
(öffentliche Mitgliedsfunktion von
std::filesystem::directory_entry
)
|