std::filesystem::directory_entry::status, std::filesystem::directory_entry::symlink_status
提供: cppreference.com
<tbody>
</tbody>
std::filesystem::file_status status() const; std::filesystem::file_status status( std::error_code& ec ) const noexcept; |
(1) | (C++17以上) |
std::filesystem::file_status symlink_status() const; std::filesystem::file_status symlink_status( std::error_code& ec ) const noexcept; |
(2) | (C++17以上) |
1) status の呼び出しによって決定されるかのような (シンボリックリンクのターゲットを辿ります)、エントリのステータスを返します。
2) symlink_status の呼び出しによって決定されるかのような (シンボリックリンクを辿りません)、エントリのステータスを返します。
引数
| ec | - | 例外を投げないオーバーロードでエラーを報告するための出力引数 |
戻り値
エントリの参照先のファイルのステータス。
例外
std::error_code& 引数を取らないオーバーロードは、ベースとなる OS の API でエラーが発生した場合、第1パス引数に p、エラーコード引数に OS のエラーコードを指定して構築された filesystem_error を投げます。 std::error_code& 引数を取るオーバーロードは、 OS の API 呼び出しが失敗した場合、その引数を OS の API のエラーコードに設定し、エラーが発生しない場合は ec.clear() を実行します。 noexcept 指定のないあらゆるオーバーロードは、メモリ確保に失敗した場合 std::bad_alloc を投げる可能性があります。
ノート
ディレクトリトラバーサルのための多くの低水準な OS の API は、次のディレクトリエントリと一緒にそのファイルの属性も取得します。 directory_iterator のコンストラクタおよび非 const メンバ関数は、 directory_entry::refresh を呼ばすに、指す先の directory_entry にこれらの属性 (もしあれば) を格納します。 これにより、追加のシステムコールを発行することなく、反復中のディレクトリエントリの属性を調べられます。
例
Run this code
#include <iostream>
#include <fstream>
#include <cstdio>
#include <cstring>
#include <filesystem>
#include <unistd.h>
#include <sys/socket.h>
#include <sys/un.h>
#include <sys/stat.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 << " is a regular file\n";
if(fs::is_directory(s)) std::cout << " is a directory\n";
if(fs::is_block_file(s)) std::cout << " is a block device\n";
if(fs::is_character_file(s)) std::cout << " is a character device\n";
if(fs::is_fifo(s)) std::cout << " is a named IPC pipe\n";
if(fs::is_socket(s)) std::cout << " is a named IPC socket\n";
if(fs::is_symlink(s)) std::cout << " is a symlink\n";
if(!fs::exists(s)) std::cout << " does not exist\n";
}
int main()
{
// create files of different kinds
fs::create_directory("sandbox");
std::ofstream("sandbox/file"); // create regular file
fs::create_directory("sandbox/dir");
mkfifo("sandbox/pipe", 0644);
struct 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, (struct sockaddr*)&addr, sizeof addr);
fs::create_symlink("file", "sandbox/symlink");
// demo different status accessors
for(auto it = fs::directory_iterator("sandbox"); it != fs::directory_iterator(); ++it)
demo_status(*it, it->symlink_status()); // use cached status from directory entry
demo_status("dev/null", fs::status("/dev/null")); // direct calls to status
demo_status("dev/sda", fs::status("/dev/sda"));
demo_status("sandbox/no", fs::status("/sandbox/no"));
// cleanup
close(fd);
fs::remove_all("sandbox");
}
出力例:
"sandbox/file" is a regular file
"sandbox/dir" is a directory
"sandbox/pipe" is a named IPC pipe
"sandbox/sock" is a named IPC socket
"sandbox/symlink" is a symlink
"dev/null" is a character device
"dev/sda" is a block device
"sandbox/no" does not exist
関連項目
| キャッシュされたファイルの属性を更新します (パブリックメンバ関数) | |
| ディレクトリエントリが参照しているファイルシステムオブジェクトが存在しているかどうか調べます (パブリックメンバ関数) | |
| ディレクトリエントリがブロックデバイスを参照しているかどうか調べます (パブリックメンバ関数) | |
| ディレクトリエントリがキャラクタデバイスを参照しているかどうか調べます (パブリックメンバ関数) | |
| ディレクトリエントリがディレクトリを参照しているかどうか調べます (パブリックメンバ関数) | |
| ディレクトリエントリが名前付きパイプを参照しているかどうか調べます (パブリックメンバ関数) | |
| ディレクトリエントリがその他のファイルを参照しているかどうか調べます (パブリックメンバ関数) | |
| ディレクトリエントリが普通のファイルを参照しているかどうか調べます (パブリックメンバ関数) | |
| ディレクトリエントリが名前付き IPC ソケットを参照しているかどうか調べます (パブリックメンバ関数) | |
| ディレクトリエントリがシンボリックリンクを参照しているかどうか調べます (パブリックメンバ関数) | |
| ディレクトリエントリが参照しているファイルのサイズを返します (パブリックメンバ関数) | |
| ディレクトリエントリが参照しているファイルを参照しているハードリンクの数を返します (パブリックメンバ関数) | |
| ディレクトリエントリが参照しているファイルの最終更新時刻を取得または設定します (パブリックメンバ関数) |