directory_entry 類別

描述 *X所傳回的物件，其中 X 是 directory_iterator 或 recursive_directory_iterator。

語法

class directory_entry;

備註

此類別會儲存 path 類型的物件。 預存的 path 可以是 path 類別的執行個體，或衍生自 path 之類型的執行個體。 它也會儲存兩個 file_type 值。 一個值代表預存檔名的狀態。 另一個代表檔名的符號連結狀態。

如需詳細資訊與程式碼範例，請參閱檔案系統巡覽 (C++)。

建構函式

建構函式	描述
directory_entry	預設建構函式會如預期般運作。 第四個建構函式會初始化為 pval、 mystatstat_arg，以及mysymstat初始化為 symstat_arg。mypath

成員函式

成員函數	描述
assign	成員函式會將 pval 指派給 mypath、stat 指派給 mystat，並將 symstat 指派給 mysymstat。
path	此成員函式會傳回 mypath。
replace_filename	成員函式會將 mypath 取代為 mypath.parent_path() / pval、 mystat stat_arg 和 symstat_arg mysymstat
status	這兩個成員函式都會傳回 mystat 可能先改變。
symlink_status	這兩個成員函式都會傳回 mysymstat 可能先改變。

操作員

運算子	描述
operator!=	用另一個清單複本取代清單的元素。
operator=	預設成員指派運算子會如預期般運作。
operator==	傳回 mypath == right.mypath。
運算子<	傳回 mypath < right.mypath。
operator<=	傳回 !(right < *this)。
運算子>	傳回 right < *this。
operator>=	傳回 !(*this < right)。
operator const path_type&	傳回 mypath。

需求

標頭：<experimental/filesystem>

命名空間：std::experimental::filesystem

assign

成員函式會將 pval 指派給 mypath、 stat_arg 給 mystat，並將 symstat_arg 指派給 mysymstat。

void assign(const std::experimental::filesystem::path& pval,
    file_status stat_arg = file_status(),
    file_status symstat_arg = file_status());

參數

pval
預存檔名路徑。

stat_arg
預存檔名的狀態。

symstat_arg
預存檔名的符號連結狀態。

directory_entry

預設建構函式會如預期般運作。 第四個建構函式會初始化為 pval、 mystatstat_arg，以及mysymstat初始化為 symstat_arg。mypath

directory_entry() = default;
directory_entry(const directory_entry&) = default;
directory_entry(directory_entry&&) noexcept = default;
explicit directory_entry(const std::experimental::filesystem::path& pval,
    file_status stat_arg = file_status(),
    file_status symstat_arg = file_status());

參數

pval
預存檔名路徑。

stat_arg
預存檔名的狀態。

symstat_arg
預存檔名的符號連結狀態。

operator!=

此成員函式會傳回 !(*this == right)。

bool operator!=(const directory_entry& right) const noexcept;

參數

right
與比較directory_entrydirectory_entry。

operator=

預設成員指派運算子會如預期般運作。

directory_entry& operator=(const directory_entry&) = default;
directory_entry& operator=(directory_entry&&) noexcept = default;

參數

right
要複製到的directory_entrydirectory_entry。

operator==

此成員函式會傳回 mypath == right.mypath。

bool operator==(const directory_entry& right) const noexcept;

參數

right
與比較directory_entrydirectory_entry。

operator<

此成員函式會傳回 mypath < right.mypath。

bool operator<(const directory_entry& right) const noexcept;

參數

right
與比較directory_entrydirectory_entry。

operator<=

此成員函式會傳回 !(right < *this)。

bool operator<=(const directory_entry& right) const noexcept;

參數

right
與比較directory_entrydirectory_entry。

operator>

此成員函式會傳回 right < *this。

bool operator>(const directory_entry& right) const noexcept;

參數

right
與比較directory_entrydirectory_entry。

operator>=

此成員函式會傳回 !(*this < right)。

bool operator>=(const directory_entry& right) const noexcept;

參數

right
與比較directory_entrydirectory_entry。

operator const path_type&

此成員運算子會傳回 mypath。

operator const std::experimental::filesystem::path&() const;

path

此成員函式會傳回 mypath。

const std::experimental::filesystem::path& path() const noexcept;

replace_filename

成員函式會將 mypath 取代為 mypath.parent_path() / pval、 mystat stat_arg 和 symstat_arg mysymstat

void replace_filename(
    const std::experimental::filesystem::path& pval,
    file_status stat_arg = file_status(),
    file_status symstat_arg = file_status());

參數

pval
預存檔名路徑。

stat_arg
預存檔名的狀態。

symstat_arg
預存檔名的符號連結狀態。

status

這兩個成員函式都會傳回 mystat 可能先改變，如下所示：

1. 如果 status_known(mystat) 的話，則不執行任何動作。

2. 否則，如果為 mystat = mysymstat，則!status_known(mysymstat) && !is_symlink(mysymstat)為 。

file_status status() const;
file_status status(error_code& ec) const noexcept;

參數

電子商務
狀態錯誤碼。

symlink_status

這兩個成員函式都會傳回 mysymstat 可能先改變，如下所示：若 status_known(mysymstat) 未執行任何動作。 否則為 mysymstat = symlink_status(mypval)。

file_status symlink_status() const;
file_status symlink_status(error_code& ec) const noexcept;

參數

電子商務
狀態錯誤碼。

另請參閱

標頭檔參考
<filesystem>