Namespaces
Variants

std::filesystem::directory_entry:: is_directory

From cppreference.net
C++
Filesystem library
Classes
Functions
File types
std::filesystem::directory_entry
Member functions
Modifiers
Observers
directory_entry::is_directory
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20) (C++20)
Non-member functions
bool is_directory ( ) const ;
(1) (C++17以降)
bool is_directory ( std:: error_code & ec ) const noexcept ;
(2) (C++17以降)

指し示されたオブジェクトがディレクトリであるかどうかをチェックします。実質的に以下を返します：

1) std:: filesystem :: is_directory ( status ( ) ) ,
2) std:: filesystem :: is_directory ( status ( ec ) ) .

目次

パラメータ

ec - 例外を投げないオーバーロードにおけるエラー報告用の出力パラメータ

戻り値

true 参照先のファイルシステムオブジェクトがディレクトリである場合、 false それ以外の場合。

例外

noexcept でマークされていないオーバーロードは、 メモリ確保に失敗した場合 std::bad_alloc をスローする可能性があります。

1) 基盤となるOS APIエラーが発生した場合 std::filesystem::filesystem_error をスローします。これは p を第一パス引数、OSエラーコードをエラーコード引数として構築されます。
2) オペレーティングシステムAPI呼び出しが失敗した場合、 std:: error_code & パラメータにOS APIエラーコードを設定し、エラーが発生しなかった場合は ec. clear ( ) を実行します。

例

このコードを実行 
#include <filesystem>
#include <iostream>
#include <string_view>
namespace fs = std::filesystem;
void check_directory(fs::directory_entry const& d, std::string_view rem = "")
{
    std::cout << "is_directory(" << d << "): " << d.is_directory() << rem << '\n';
}
int main()
{
    fs::directory_entry d1(".");
    fs::directory_entry d2("file.txt");
    fs::directory_entry d3("new_dir");
    std::cout << std::boolalpha;
    check_directory(d1);
    check_directory(d2);
    check_directory(d3, " (has not been created yet).");
    std::filesystem::create_directory("new_dir");
    check_directory(d3, " (before refresh).");
    d3.refresh();
    check_directory(d3, " (after refresh).");
}

出力例: 

is_directory("."): true
is_directory("file.txt"): false
is_directory("new_dir"): false (has not been created yet).
is_directory("new_dir"): false (before refresh).
is_directory("new_dir"): true (after refresh).

関連項目

(C++17)
指定されたパスがディレクトリを参照しているかどうかをチェックする
(関数)