構造体

FilePath

ファイルシステム内の位置を表します。

iOS 14.0+ iPadOS 14.0+ Mac Catalyst 14.0+ macOS 11.0+

tvOS 14.0+ visionOS 1.0+ watchOS 7.0+

struct FilePath

概観

この構造体は、ディレクトリ区切り文字 (/ など) やルートを認識し、コンテンツが NUL (0x0) で終了することを要求します。それ以外は、含まれるバイトに意味はありません。コンテンツがどのように解釈されるかは、ファイルシステムによって定義されます (たとえば、文字列コード化の選択によって)。

構築時に、FilePath は、冗長な中間区切り文字を削除し、末尾の区切り文字を削除することで区切り文字を正規化します。Windows では、FilePath は、プラットフォームの推奨に従って、スラッシュ / を逆スラッシュ\ に正規化します。

以下のコードは、文字列リテラルからファイルパスを作成し、それを使用してログファイルを開いて追加します。

let message: String = "This is a log message."
let path: FilePath = "/tmp/log"
let fd = try FileDescriptor.open(path, .writeOnly, options: .append)
try fd.closeAfter { try fd.writeAll(message.utf8) }

ファイルパスは、プロトコルの操作を生のバイトコンテンツに対して実行することで、Equatable プロトコルと Hashable プロトコルに準拠します。この準拠により、ファイルパスを例えば辞書内のキーなどとして使用できるようになります。ただし、パスの等価性のルールはファイルシステム固有であり、大文字と小文字の区別をせず、Unicode の正規化、シンボリックリンクなどの追加の考慮事項があります。