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

 

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

 

Filesystemライブラリ (ISO/IEC TS 18822:2015) は、ファイルシステムおよびそのコンポーネント（パス、通常ファイル、ディレクトリなど）に対する操作を実行するための機能を提供します。

このライブラリはオプションの技術仕様であり、階層型ファイルシステムが実装からアクセスできない場合、または必要な機能を提供しない場合は利用できないことがあります。基盤となるファイルシステムでサポートされていない機能（例：FATファイルシステムにはハードリンク、ソフトリンク、その他の機能がない）は利用できない場合があります。

このライブラリの関数呼び出しが「ファイルシステム競合」（つまり、複数のスレッド、プロセス、またはコンピュータがファイルシステム内の同じオブジェクトへのアクセスと変更をインターリーブする）を引き起こす場合、その動作は未定義です。

このライブラリは、この実験的な技術仕様よりも多くのコンパイラやプラットフォームで現在利用可能なboost.filesystemに直接基づいています。

ライブラリ全体での定義

• ファイル: データを保持し、書き込み、読み取り、またはその両方が可能なファイルシステムオブジェクト。ファイルには名前と属性があり、そのうちの1つがファイルタイプです。

• ディレクトリ: ディレクトリのエントリ（他のファイル（その中には他のネストされたディレクトリも含まれる）を識別する）を格納するファイル。特定のファイルについて議論する場合、そのファイルがエントリとして現れるディレクトリは親ディレクトリです。親ディレクトリは相対パス名".."で表すことができます。
• ハードリンク: 既存のファイルに名前を関連付けるディレクトリエントリ。複数のハードリンクがサポートされている場合、ファイルはそれへの最後のハードリンクが削除された後に削除されます。
• シンボリックリンク: 名前をパスに関連付けるディレクトリエントリで、そのパスは存在する場合も存在しない場合もあります。
• 通常ファイル: 他のファイルタイプではないファイル。

• ファイル名: ファイルに名前を付ける文字列。許可される文字、大文字・小文字の区別、最大長、および禁止される名前は実装定義です。. (ドット) および .. (ドットドット) という名前はライブラリレベルで特別な意味を持ちます。
• パス: ファイルを識別する要素のシーケンス。オプションのルート名（例："C:"または"//server"）で始まり、オプションのルートディレクトリ（例：Unixの"/"）が続き、ゼロ個以上のファイル名（最後の1つを除くすべてがディレクトリまたはディレクトリへのリンクである必要があります）のシーケンスが続きます。パスの文字列表現（パス名）のネイティブフォーマット（例：区切り文字として使用される文字）と文字エンコーディングは実装定義であり、このライブラリはパスの移植可能な表現を提供します。

• 絶対パス: ファイルの位置を一意に識別するパス。
• 正規パス: シンボリックリンク、"."または".."要素を含まない絶対パス。
• 相対パス: ファイルシステム上の何らかの場所に対するファイルを識別するパス。特殊なパス名. (ドット、「現在のディレクトリ」) と .. (ドットドット、「親ディレクトリ」) は相対パスです。

クラス

path	パスを表現する (クラス)
filesystem_error	ファイルシステムエラーでスローされる例外 (クラス)
directory_entry	ディレクトリエントリ (クラス)
directory_iterator	ディレクトリの内容を指すイテレータ (クラス)
recursive_directory_iterator	ディレクトリとそのサブディレクトリの内容を指すイテレータ (クラス)
file_status	ファイルの種別とパーミッションを表現する (クラス)
space_info	ファイルシステムの空き容量と利用可能容量に関する情報 (クラス)
file_type	ファイルの種別 (列挙型)
perms	ファイルシステムのパーミッションを識別する (列挙型)
copy_options	コピー操作のセマンティクスを指定する (列挙型)
directory_options	ディレクトリの内容をイテレートするためのオプション (列挙型)
file_time_type	ファイルの時刻値を表現する (typedef)

非メンバ関数

absolutesystem_complete	絶対パスを構成する OS固有の動作を複製してパスを絶対パスに変換します (関数)
canonical	正規パスを構成する (関数)
copy	ファイルまたはディレクトリをコピーする (関数)
copy_file	ファイルの内容をコピーする (関数)
copy_symlink	シンボリックリンクをコピーする (関数)
create_directorycreate_directories	新しいディレクトリを作成する (関数)
create_hard_link	ハードリンクを作成する (関数)
create_symlinkcreate_directory_symlink	シンボリックリンクを作成する (関数)
current_path	現在の作業ディレクトリを返します (関数)
exists	パスが既存のファイルシステムオブジェクトを参照しているか確認する (関数)
equivalent	2つのパスが同じファイルシステムオブジェクトを参照しているか確認する (関数)
file_size	ファイルのサイズを返す (関数)
hard_link_count	特定のファイルを参照しているハードリンクの数を返す (関数)
last_write_time	最終データ変更日時を取得または設定する (関数)
permissions	ファイルのアクセスパーミッションを変更する (関数)
read_symlink	シンボリックリンクのターゲットを取得する (関数)
removeremove_all	ファイルまたは空のディレクトリを削除する ファイルまたはディレクトリとその内容をすべて再帰的に削除する (関数)
rename	ファイルまたはディレクトリを移動または名前変更する (関数)
resize_file	通常ファイルのサイズを切り詰めまたはゼロ埋めで変更する (関数)
スペース	ファイルシステム上の利用可能な空き容量を決定する (関数)
statussymlink_status	ファイルの属性を決定する シンボリックリンクのターゲットを確認してファイルの属性を決定する (関数)
temp_directory_path	一時ファイルに適したディレクトリを返す (関数)
ファイル種別
is_block_file	指定されたパスがブロックデバイスを参照しているか確認する (関数)
is_character_file	指定されたパスがキャラクタデバイスを参照しているか確認する (関数)
is_directory	指定されたパスがディレクトリを参照しているか確認する (関数)
is_empty	指定されたパスが空のファイルまたはディレクトリを参照しているか確認する (関数)
is_fifo	指定されたパスが名前付きパイプを参照しているか確認する (関数)
is_other	引数がその他のファイルを参照しているか確認する (関数)
is_regular_file	引数が通常ファイルを参照しているか確認する (関数)
is_socket	引数が名前付きIPCソケットを参照しているか確認する (関数)
is_symlink	引数がシンボリックリンクを参照しているか確認する (関数)
status_known	ファイルステータスが既知かどうかを確認する (関数)

関連項目

C++ドキュメント ( ファイルシステムライブラリ (C++17) )