directory_entry 類別
描述 *X所傳回的物件，其中 X 是 directory_iterator 或 recursive_directory_iterator。
語法
class directory_entry;
備註
此類別會儲存 path 類型的物件。 預存的 path 可以是 path 類別的執行個體，或衍生自 path 之類型的執行個體。 它也會儲存兩個 file_type 值。 一個值代表預存檔名的狀態。 另一個代表檔名的符號連結狀態。
如需詳細資訊與程式碼範例，請參閱檔案系統巡覽 (C++)。
建構函式
| 建構函式 | 描述 |
|---|---|
| directory_entry | 預設建構函式會如預期般運作。 第四個建構函式會初始化為 pval、 mystat stat_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、 mystat stat_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 可能先改變，如下所示：
如果
status_known(mystat)的話，則不執行任何動作。否則，如果為
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;
參數
電子商務
狀態錯誤碼。