Class

FileWrapper

A representation of a node (a file, directory, or symbolic link) in the file system. ファイルシステムの中のあるノード（あるファイル、ディレクトリ、またはシンボリックリンク）の表現。

Declaration 宣言 

class FileWrapper : NSObject

Overview 概要

The FileWrapper class provides access to the attributes and contents of file system nodes. A file system node is a file, directory, or symbolic link. Instances of this class are known as file wrappers. FileWrapperクラスは、ファイルシステムノードの属性と内容へのアクセスを提供します。ファイルシステムノードは、ファイル、ディレクトリ、またはシンボリックリンクです。このクラスのインスタンスは、ファイルラッパーとして知られます。

File wrappers represent a file system node as an object that can be displayed as an image (and possibly edited in place), saved to the file system, or transmitted to another application. ファイルラッパーは、ファイルシステムノードを、画像として表示（そしておそらくは場に合わせて手直し）されること、ファイルシステムに保存されること、または別のアプリケーションに伝えられることが可能なオブジェクトとして表します。

There are three types of file wrappers: ３つの方のファイルラッパーがあります：

  • Regular-file file wrapper: Represents a regular file. 通常ファイルファイルラッパー： 通常のファイルを表します。

  • Directory file wrapper: Represents a directory. ディレクトリファイルラッパー： ディレクトリを表します。

  • Symbolic-link file wrapper: Represents a symbolic link. シンボリックリンクファイルラッパー： シンボリックリンクを表します。

A file wrapper has these attributes: ファイルラッパーは、これらの属性を持ちます：

  • Filename. Name of the file system node the file wrapper represents. ファイル名。 ファイルラッパーが表すファイルシステムノードの名前。

  • file-system attributes. See FileManager for information on the contents of the attributes dictionary. ファイルシステム属性。 FileManagerをattributes辞書の内容に関する情報として見てください。

  • Regular-file contents. Applicable only to regular-file file wrappers. 通常ファイル内容。 通常ファイルファイルラッパーに対してのみ適用可能です。

  • File wrappers. Applicable only to directory file wrappers. ファイルラッパー。 ディレクトリファイルラッパーに対してのみ適用可能です。

  • Destination node. Applicable only to symbolic-link file wrappers. 行き先ノード。 シンボリックリンクファイルラッパーに対してのみ適用可能です。

Topics 話題

Creating File Wrappers ファイルラッパーを作成する

This class has several designated initializers. このクラスは、いくつかの指定イニシャライザを持ちます。
init(url: URL, options: FileWrapper.ReadingOptions)
Initializes a file wrapper instance whose kind is determined by the type of file-system node located by the URL. ファイルラッパーインスタンスを初期化します、それのもつ種類はURLによって位置決めされるファイルシステムノードの型によって決定されます。
init?(path: String)
Initializes a file wrapper instance whose kind is determined by the type of file-system node located by the path. ファイルラッパーインスタンスを初期化します、それのもつ種類はパスによって位置決めされるファイルシステムノードの型によって決定されます。
Deprecated 非推奨
init(directoryWithFileWrappers: [String : FileWrapper])
Initializes the receiver as a directory file wrapper, with a given file-wrapper list. 与えられたファイルラッパーリストで、レシーバをディレクトリファイルラッパーとして初期化します。
init(regularFileWithContents: Data)
Initializes the receiver as a regular-file file wrapper. レシーバを通常ファイルファイルラッパーとして初期化します。
init(symbolicLinkWithDestination: String)
Initializes the receiver as a symbolic-link file wrapper. レシーバをシンボリックリンクファイルラッパーとして初期化します。
Deprecated 非推奨
init(symbolicLinkWithDestinationURL: URL)
Initializes the receiver as a symbolic-link file wrapper that links to a specified file. レシーバをシンボリックリンクファイルラッパーとして初期化します、それは指定されたファイルにリンクされます。
init?(serializedRepresentation: Data)
Initializes the receiver as a regular-file file wrapper from given serialized data. 与えられたシリアライズされたデータから、レシーバを通常ファイルファイルラッパーとして初期化します。

Querying File Wrappers ファイルラッパーに問い合わせる

var isRegularFile: Bool
This property contains a boolean value that indicates whether the file wrapper object is a regular-file. このプロパティはブール値を含みます、それはファイルラッパーオブジェクトが通常ファイルかどうかを指し示します。
var isDirectory: Bool
This property contains a boolean value indicating whether the file wrapper is a directory file wrapper. このプロパティはブール値を含みます、ファイルラッパーがディレクトリファイルラッパーかどうかを指し示しています。
var isSymbolicLink: Bool
A boolean that indicates whether the file wrapper object is a symbolic-link file wrapper. ブール値、それはファイルラッパーオブジェクトがシンボリックリンクファイルラッパーかどうかを指し示します。

Accessing File-Wrapper Information ファイルラッパー情報にアクセスする

var fileWrappers: [String : FileWrapper]?
The file wrappers contained by a directory file wrapper. ファイルラッパーは、ディレクトリファイルラッパーによって含まれます。
func addFileWrapper(FileWrapper) -> String
Adds a child file wrapper to the receiver, which must be a directory file wrapper. 子ファイルラッパーをレシーバに追加します、それはディレクトリファイルラッパーでなければなりません。
func removeFileWrapper(FileWrapper)
Removes a child file wrapper from the receiver, which must be a directory file wrapper. 子ファイルラッパーをレシーバから取り除きます、それはディレクトリファイルラッパーでなければなりません。
func addFile(withPath: String) -> String
Creates a file wrapper from a given file-system node and adds it to the receiver, which must be a directory file wrapper. ファイルラッパーをある与えられたファイルシステムノードから作成してそれをレシーバに加えます、それはディレクトリファイルラッパーでなければなりません。
Deprecated 非推奨
func addRegularFile(withContents: Data, preferredFilename: String) -> String
Creates a regular-file file wrapper with the given contents and adds it to the receiver, which must be a directory file wrapper. 与えられた内容を持つ通常ファイルファイルラッパーを作成してそれをレシーバに加えます、それはディレクトリファイルラッパーでなければなりません。
func addSymbolicLink(withDestination: String, preferredFilename: String) -> String
Creates a symbolic-link file wrapper pointing to a given file-system node and adds it to the receiver, which must be a directory file wrapper. ある与えられたファイルシステムノードを指すシンボリックリンクファイルラッパーを作成してそれをレシーバに加えます、それはディレクトリファイルラッパーでなければなりません。
Deprecated 非推奨
func keyForChildFileWrapper(FileWrapper) -> String?
Returns the dictionary key used by a directory to identify a given file wrapper. 与えられたファイルラッパーを識別する、ディレクトリによって使われる辞書キーを返します。
func symbolicLinkDestination() -> String
Provides the pathname referenced by the file wrapper object, which must be a symbolic-link file wrapper. ファイルラッパーオブジェクト、それはシンボリックリンクファイルラッパーである必要があります、によって参照されるパス名を提供します。
Deprecated 非推奨
var symbolicLinkDestinationURL: URL?
The URL referenced by the file wrapper object, which must be a symbolic-link file wrapper. ファイルラッパーオブジェクトによって参照されるURL、それはシンボリックリンクファイルラッパーでなければなりません。

Updating File Wrappers ファイルラッパーを更新する

func needsToBeUpdated(fromPath: String) -> Bool
Indicates whether the file wrapper needs to be updated to match a given file-system node. 与えられたファイルシステムノードに合致するためにファイルラッパーが更新されることを必要とするかどうかを指し示します。
Deprecated 非推奨
func matchesContents(of: URL) -> Bool
Indicates whether the contents of a file wrapper matches a directory, regular file, or symbolic link on disk. ファイルラッパーの内容がディスク上のディレクトリ、通常ファイル、またはシンボリックリンクと合致するかどうかを指し示します。
func update(fromPath: String) -> Bool
Updates the file wrapper to match a given file-system node. ファイルラッパーをある与えられたファイルシステムノードと合致するよう更新します。
Deprecated 非推奨
func read(from: URL, options: FileWrapper.ReadingOptions)
Recursively rereads the entire contents of a file wrapper from the specified location on disk. ディスク上の指定された場所から、ファイルラッパーの全内容を再帰的に再読み込みします。

Serializing シリアライズ

var serializedRepresentation: Data?
The contents of the file wrapper as an opaque data object. ファイルラッパーの内容、不透明データオブジェクトとして。

Accessing Files ファイルにアクセスする

var filename: String?
The filename of the file wrapper object ファイルラッパーオブジェクトのファイル名。
var preferredFilename: String?
The preferred filename for the file wrapper object. ファイルラッパーオブジェクトに対する優先ファイル名。
var fileAttributes: [String : Any]
A dictionary of file attributes. ファイル属性の辞書。
var regularFileContents: Data?
The contents of the file-system node associated with a regular-file file wrapper. 通常ファイルファイルラッパーと結び付けられるファイルシステムノードの内容。

Writing Files ファイル書き出し

func write(toFile: String, atomically: Bool, updateFilenames: Bool) -> Bool
Writes a file wrapper’s contents to a given file-system node. ファイルラッパーの持つ内容をある与えられたファイルシステムノードに書き込みます。
Deprecated 非推奨
func write(to: URL, options: FileWrapper.WritingOptions, originalContentsURL: URL?)
Recursively writes the entire contents of a file wrapper to a given file-system URL. 与えられたファイルシステムURLへと、ファイルラッパーの全内容を再帰的に書き込みます。

Working with Icons アイコンを扱う

var icon: NSImage?
The icon that represents the file wrapper. ファイルラッパーを表すアイコン。

Constants 定数

struct FileWrapper.ReadingOptions
Reading options that can be set by the init(url:options:) and read(from:options:) methods. init(url:options:)とread(from:options:)メソッドによって設定されることが可能である読み出しオプション。
struct FileWrapper.WritingOptions
Writing options that can be set by the write(to:options:originalContentsURL:) method. write(to:options:originalContentsURL:)メソッドによって設定されることが可能である書き込みオプション。

Initializers イニシャライザ

init?(coder: NSCoder)

Relationships 関係

Inherits From 継承元

Conforms To 次に準拠

See Also 参照

Managed File Access ファイルアクセスを管理する

class FileHandle
An object-oriented wrapper for a file descriptor. ファイル記述子のためのオブジェクト指向のラッパー。
class NSFileSecurity
A stub class that encapsulates security information about a file. あるファイルについての保安情報をカプセル化するスタブクラス。
class NSFileVersion
A snapshot of a file at a specific point in time. 特定の時点でのあるファイルのスナップショット。