std::experimental::filesystem::path

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

実験的

Technical Specification

ファイルシステムライブラリ (filesystem TS)

ライブラリ基本 (library fundamentals TS)

ライブラリ基本TS v2 (library fundamentals TS v2)

ライブラリ基本 3 (library fundamentals TS v3)

並列化拡張 (parallelism TS)

並列化拡張 2 (parallelism TS v2)

並行処理拡張 (concurrency TS)

並行処理拡張 2 (concurrency TS v2)

コンセプト (concepts TS)

Ranges (ranges TS)

リフレクション (reflection TS)

数学特殊関数 (special functions TR)

実験的 (非TS)

パターンマッチ

線形代数

std::execution

契約プログラミング

2Dグラフィックス

 

ファイルシステムライブラリ

クラス
filesystem::path filesystem::filesystem_error filesystem::directory_entry filesystem::directory_iterator filesystem::recursive_directory_iterator filesystem::file_status	filesystem::space_info filesystem::file_type filesystem::perms filesystem::copy_options filesystem::directory_options filesystem::file_time_type
関数
filesystem::absolute filesystem::system_complete filesystem::canonical filesystem::copy filesystem::copy_file filesystem::copy_symlink filesystem::create_directory filesystem::create_directories filesystem::create_hard_link filesystem::create_symlink filesystem::create_directory_symlink filesystem::current_path filesystem::exists filesystem::equivalent	filesystem::file_size filesystem::hard_link_count filesystem::last_write_time filesystem::permissions filesystem::read_symlink filesystem::remove filesystem::remove_all filesystem::rename filesystem::resize_file filesystem::space filesystem::status filesystem::symlink_status filesystem::temp_directory_path
ファイル種別
filesystem::is_block_file filesystem::is_character_file filesystem::is_directory filesystem::is_empty filesystem::status_known	filesystem::is_fifo filesystem::is_other filesystem::is_regular_file filesystem::is_socket filesystem::is_symlink

 

path

メンバ関数
path::path path::~path path::operator= path::assign path::appendoperator /= path::concatoperator += path::clear path::make_preferred path::remove_filename path::replace_filename path::replace_extension path::swap path::compare	path::c_strpath::nativeoperator string_type path::stringpath::u8stringpath::u16stringpath::u32stringpath::wstring path::generic_stringpath::generic_u8stringpath::generic_u16stringpath::generic_u32stringpath::generic_wstring path::beginpath::end
パスの分解
path::root_name path::root_directory path::root_path path::relative_path path::parent_path path::filename path::stem path::extension path::empty	path::has_root_pathpath::has_root_namepath::has_root_directorypath::has_relative_pathpath::has_parent_pathpath::has_filenamepath::has_stempath::has_extension path::is_absolutepath::is_relative
非メンバ関数
swap(path)
operator==operator!=operator<operator<=operator>operator>=
operator/
operator<<operator>>
u8path

 

ヘッダー <experimental/filesystem> で定義されています
class path;		(filesystem TS)

path 型のオブジェクトは、ファイルシステムのパスを表します。パスの構文的な側面のみが処理されます。パス名は、存在しないパス、あるいは現在のファイルシステムや OS で存在が許可されていないパスを表すこともあります。

パス名は以下の構文を持ちます。

1. root-name(optional): 複数のルートを持つファイルシステム (例: "C:" や "//myserver") におけるルートを識別します。POSIX ファイルシステムは単一のルートを持ちます。
2. root-directory(optional): ディレクトリ区切り文字。存在する場合、このパスを *絶対パス* としてマークします。これが欠落している場合 (そして、ルート名以外の最初の要素がファイル名である場合)、パスは *相対パス* となり、ファイル名を解決するために別のパスを開始位置として必要とします。
3. ゼロ個以上の以下の要素:

• file-name: ディレクトリ区切り文字でも推奨ディレクトリ区切り文字でもない一連の文字 (OS やファイルシステムによって追加の制限が課される場合があります)。この名前は、ファイル、ハードリンク、シンボリックリンク、またはディレクトリを識別できます。2 つの特別な file-name が認識されます。

• dot: 単一のドット文字 . からなるファイル名は、現在のディレクトリを参照するディレクトリ名です。
• dot-dot: 2 つのドット文字 .. からなるファイル名は、親ディレクトリを参照するディレクトリ名です。

• directory-separators: フォワードスラッシュ文字 / または path::preferred_separator として提供される代替文字。この文字が繰り返された場合、単一のディレクトリ区切り文字として扱われます: /usr///////lib は /usr/lib と同じです。

begin() および end() 関数によって返されるイテレータを使用して、パスを要素ごとにたどることができます。これらは、ルート名、ルートディレクトリ、および後続のファイル名要素を反復処理します (ルートディレクトリを識別するものを除き、ディレクトリ区切り文字はスキップされます)。パスの最後の要素がディレクトリ区切り文字の場合、最後のイテレータはファイル名 dot を逆参照します。

path の非 const メンバ関数を呼び出すと、そのオブジェクトの要素を参照するすべてのイテレータが無効になります。

OS が上記で説明したポータブルな *汎用* 構文とは異なる *ネイティブ* 構文を使用する場合、すべてのライブラリ関数は両方の形式のパス名を受け入れます。

パスは std::basic_string との間で暗黙的に変換可能であり、これにより、他のファイル API (例: std::ifstream::open の引数) で使用できます。

メンバ型

型	定義
value_type	ファイルシステムのネイティブエンコーディングで使用される文字型: POSIX では char、Windows では wchar_t
string_type	std::basic_string<value_type>
const_iterator	value_type が path である定数 LegacyBidirectionalIterator
iterator	const_iterator へのエイリアス

メンバ定数

constexpr value_type preferred_separator [static]

ポータブルな / に加えて使用できる代替ディレクトリセパレータ。Windows ではバックスラッシュ文字 \ です。POSIX では、ポータブルセパレータと同じフォワードスラッシュ / です。 (公開静的メンバ定数)

メンバ関数

(コンストラクタ)	path を構築します。 (public member function)
(デストラクタ)	path オブジェクトを破棄します。 (public member function)
operator=	別のパスを代入します。 (public member function)
代入する	内容を代入する (public member function)
連結
appendoperator/=	パスに要素を追加します。 (public member function)
concatoperator+=	ディレクトリセパレータを導入せずに2つのパスを連結します。 (public member function)
変更
clear	内容を削除します。 (public member function)
make_preferred	ディレクトリ区切り文字を推奨ディレクトリ区切り文字に変換します。 (public member function)
remove_filename	ファイル名のパスコンポーネントを削除します。 (public member function)
replace_filename	最後のパスコンポーネントを別のパスに置き換えます。 (public member function)
replace_extension	拡張子を置き換えます。 (public member function)
swap	2つのパスをスワップします。 (public member function)
フォーマットオブザーバー
c_strnativeoperator string_type	パスのネイティブバージョンを返します。 (public member function)
stringwstringu8stringu16stringu32string	パスをネイティブパス名形式から文字列に変換して返します。 (public member function)
generic_stringgeneric_wstringgeneric_u8stringgeneric_u16stringgeneric_u32string	パスをジェネリックパス名形式から文字列に変換して返します。 (public member function)
Compare
compare	2つのパスの字列表現を辞書順に比較します (public member function)
分解
root_name	パスのルート名を返します（存在する場合）。 (public member function)
root_directory	パスのルートディレクトリを返します（存在する場合）。 (public member function)
root_path	パスのルートパスを返します（存在する場合）。 (public member function)
relative_path	ルートパスに対する相対パスを返します。 (public member function)
parent_path	親パスのパスを返します。 (public member function)
filename	ファイル名のパスコンポーネントを返します。 (public member function)
stem	ステムパスコンポーネントを返します。 (public member function)
extension	ファイルの拡張子パスコンポーネントを返します。 (public member function)
問い合わせ
empty	パスが空かどうかをチェックする (public member function)
has_root_pathhas_root_namehas_root_directoryhas_relative_pathhas_parent_pathhas_filenamehas_stemhas_extension	対応するパス要素が空でないかどうかをチェックします。 (public member function)
is_absoluteis_relative	root_path() がファイルシステムの位置を一意に識別するかどうかをチェックします。 (public member function)
イテレータ
beginend	パスへの要素のシーケンスとしてのイテレータアクセス。 (public member function)

非メンバ関数

swap(std::experimental::filesystem::path)	2つのパスをスワップします。 (function)
operator==operator!=operator<operator<=operator>operator>=	2つのパスを辞書順に比較します (function)
operator/	ディレクトリセパレータで2つのパスを連結します。 (function)
operator<<operator>>	パスに対するストリーム入出力を行います。 (function)
u8path	UTF-8エンコードされたソースから`path`を作成 (function)