Structure

URLResourceValues

The properties supported by file system resources. ファイルシステムリソースによってサポートされるプロパティ。

Declaration 宣言

struct URLResourceValues

Overview 概要

URLs to file system resources support the properties defined below. Note that not all property values will exist for all file system URLs. For example, if a file is located on a volume that does not support creation dates, it is valid to request the creation date property, but the returned value will be nil, and no error will be generated. ファイルシステムリソースへのURLは、下で定義されるプロパティをサポートします。全てのプロパティ値が全てのシステムURLに対して存在しないことに注意してください。例えば、あるファイルが作成日をサポートしないボリューム上に置かれるならば、それが作成日プロパティを要請されるのは有効です、しかし戻り値はnilでしょう、そしてどんなエラーも生成されません。

Only the fields requested by the keys you pass into the URL function to receive this value will be populated. The others will return nil regardless of the underlying property on the file system. あなたがURL関数へと渡してここにある値を受け取るキーそれらによって要請されるフィールドだけが、満たされることになります。その他は nilを返すでしょう、そのファイルシステム上の基礎をなすプロパティに関係なく。

As a convenience, volume resource values can be requested from any file system URL. The value returned will reflect the property value for the volume on which the resource is located. ある便宜として、ボリュームリソース値はどんなファイルシステムURLにも要請されることが可能です。返される値は、それの上にリソースが置かれるところのボリュームに対するプロパティ値を反映するでしょう。

Topics 話題

Application Values アプリケーション値

var applicationIsScriptable: Bool?

True if the resource is scriptable. Only applies to applications. リソースがスクリプト対応であるならば、true。アプリケーションにだけ当てはまります。

var isApplication: Bool?

True if resource is an application. リソースがアプリケーションであるならば、true。

Directory Values ディレクトリ値

var isDirectory: Bool?

True for directories. ディレクトリに対してtrue。

File Values ファイル値

var documentIdentifier: Int?

The document identifier – a value assigned by the kernel to a document (which can be either a file or directory) and is used to identify the document regardless of where it gets moved on a volume. 書類識別子 – カーネルによってある書類（それはファイルまたはディレクトリのどちらでもあることができる）へと割り当てられる値、そしてその書類をあるボリューム上でどこにそれが移動されるかに関係なく識別するのに使われます。

var fileAllocatedSize: Int?

Total size allocated on disk for the file in bytes (number of blocks times block size) ディスク上でファイルに対して割り当てられるバイトでの合計サイズ（ブロックの数はブロックサイズで計られます）。

var fileProtection: URLFileProtection?

The protection level for this file このファイルに対する保護レベル。

var fileResourceIdentifier: (NSCopying & NSSecureCoding & NSObjectProtocol)?

An identifier which can be used to compare two file system objects for equality using isEqual. ２つのファイルシステムオブジェクトを同等性についてisEqualを使って比較するのに使用できる識別子。

var fileResourceType: URLFileResourceType?

Returns the file system object type. ファイルシステムオブジェクト型を返します。

var fileSecurity: NSFileSecurity?

The file system object’s security information encapsulated in a FileSecurity object. ファイルシステムオブジェクトのもつ、FileSecurityオブジェクトの中にカプセル化される保安情報。

var fileSize: Int?

Total file size in bytes バイトでの合計ファイルサイズ。

var isExecutable: Bool?

True if this process (as determined by EUID) can execute a file resource or search a directory resource. このプロセス（EUIDによって決定される）がファイルリソースを遂行またはディレクトリリソースを検索できるならば、true。

var isRegularFile: Bool?

True for regular files. 一般ファイルに対してtrue。

var totalFileAllocatedSize: Int?

Total allocated size of the file in bytes (this may include space used by metadata), or nil if not available. This can be less than the value returned by totalFileSize if the resource is compressed. バイト数でのファイルの合計割り当てサイズ（これはメタデータによって使われる空間も含むかもしれません）、または利用可能でないならばnil。これは、totalFileSizeによって返される値より少ない可能性があります、もしリソースが圧縮されるならば。

var totalFileSize: Int?

Total displayable size of the file in bytes (this may include space used by metadata), or nil if not available. バイト数でのファイルの合計表示用途サイズ（これはメタデータによって使われる空間も含むかもしれません）、または利用可能でないならばnil。

Volume Capacity Values ボリューム容量値

var volumeAvailableCapacity: Int?

The volume’s available capacity in bytes. バイトでのボリュームのもつ利用可能容量。

var volumeAvailableCapacityForImportantUsage: Int64?

The volume’s available capacity in bytes for storing important resources. 重要なリソースを格納するための、バイトでのボリュームのもつ利用可能容量。

var volumeAvailableCapacityForOpportunisticUsage: Int64?

The volume’s available capacity in bytes for storing nonessential resources. 重要でないリソースを格納するための、バイトでのボリュームのもつ利用可能容量。

var volumeTotalCapacity: Int?

The volume’s total capacity in bytes. バイトでのボリュームのもつ合計容量。

Volume Status Values ボリューム状態値

var volumeIsAutomounted: Bool?

true if the volume is automounted. Note: do not mistake this with the functionality provided by kCFURLVolumeSupportsBrowsingKey. ボリュームが自動マウントされるならば、true。注意：これをkCFURLVolumeSupportsBrowsingKey によって提供される機能性と間違えないでください。

var volumeIsBrowsable: Bool?

True if the volume should be visible through the user interface (in effect, appear on the Desktop as a separate volume). ボリュームがユーザインターフェイスによって可視であるべきならば、true（実際には、Desktop上に別個のボリュームとして現れます）。

var volumeIsEjectable: Bool?

true if the volume’s media is ejectable from the drive mechanism under software control. ボリュームのもつメディアがドライブ機構からソフトウェア制御の下で排出可能であるならば、true。

var volumeIsEncrypted: Bool?

true if the volume is encrypted. ボリュームが暗号化されるならば、true。

var volumeIsInternal: Bool?

true if the volume’s device is connected to an internal bus, false if connected to an external bus, or nil if not available. ボリュームのもつデバイスが内部バスに接続されるならば true、外部バスに接続されるならば false、または利用可能でないならば nil。

var volumeIsJournaling: Bool?

true if the volume is currently using a journal for speedy recovery after an unplanned restart. ボリュームが現在はジャーナルを予想外の再始動の後に素早く復旧するために使用しているならば、true。

var volumeIsLocal: Bool?

true if the volume is stored on a local device. ボリュームがローカルデバイス上に格納されるならば、true。

var volumeIsReadOnly: Bool?

true if the volume is read-only. ボリュームが読み出し専用ならば、true。

var volumeIsRemovable: Bool?

true if the volume’s media is removable from the drive mechanism. ボリュームのもつメディアがデバイス機構から取り外し可能ならば、true。

var volumeIsRootFileSystem: Bool?

true if the volume is the root filesystem. ボリュームがルートファイルシステムならば、true。

Volume Support Values ボリュームサポート値

var isMountTrigger: Bool?

True if this URL is a file system trigger directory. Traversing or opening a file system trigger will cause an attempt to mount a file system on the trigger directory. このURLがファイルシステムトリガーディレクトリならば、true。ファイルシステムトリガーを辿っていくまたは開くことは、あるファイルシステムをトリガーディレクトリ上でマウントする試みを引き起こすでしょう。

var isVolume: Bool?

True for the root directory of a volume. ボリュームのルートディレクトリに対してtrue。

var volume: URL?

URL of the volume on which the resource is stored. それの上でリソースが格納されるボリュームのURL。

var volumeCreationDate: Date?

The volume’s creation date, or nil if this cannot be determined. ボリュームのもつ作成日、またはこれが決定されることができないならばnil。

var volumeIdentifier: (NSCopying & NSSecureCoding & NSObjectProtocol)?

An identifier that can be used to identify the volume the file system object is on. ある識別子、それはファイルシステムオブジェクトが乗っているボリュームを識別するのに使用できます。

var volumeLocalizedFormatDescription: String?

The user-visible volume format. ユーザが見ることができるボリューム形式。

var volumeLocalizedName: String?

The user-presentable name of the volume ユーザに見せるのに適した、ボリュームの名前。

var volumeMaximumFileSize: Int?

The largest file size (in bytes) supported by this file system, or nil if this cannot be determined. このファイルシステムによってサポートされる最も大きいファイルサイズ（バイトで）、またはこれが決定されることができないならばnil。

var volumeName: String?

The name of the volume ボリュームの名前。

var volumeResourceCount: Int?

Total number of resources on the volume. ボリューム上のリソースの総数。

var volumeSupportsAccessPermissions: Bool?

A Boolean value that indicates whether the volume supports setting standard access permissions. あるブール値、それはボリュームが標準アクセス権限を設定することをサポートするかどうかを指し示します。

var volumeSupportsAdvisoryFileLocking: Bool?

true if the volume implements whole-file flock(2) style advisory locks, and the O_EXLOCK and O_SHLOCK flags of the open(2) call. ボリュームがファイル全体の flock(2) 形式の助言ロック、そして open(2) 呼び出しの O_EXLOCK と O_SHLOCK フラグを実装するならば、true。

var volumeSupportsCasePreservedNames: Bool?

true if the volume format preserves the case of file and directory names. Otherwise the volume may change the case of some characters (typically making them all upper or all lower case). ボリューム形式がファイルおよびディレクトリ名のケースを保全するならば、true。そうでなければボリュームは、いくつかの文字のケースを変更するかもしれません（概してそれらを全てアッパーまたは全てローワケースにします）。

var volumeSupportsCaseSensitiveNames: Bool?

true if the volume format treats upper and lower case characters in file and directory names as different. Otherwise an upper case character is equivalent to a lower case character, and you can’t have two names that differ solely in the case of the characters. ボリューム形式がアッパーおよびローワケース文字をファイルおよびディレクトリ名において異なるとして扱うならば、true。そうでなければアッパーケース文字はローワケース文字と等価です、そしてあなたは、文字のケースにおいてのみ異なる２つの名前を持つことができません。

var volumeSupportsCompression: Bool?

true if the volume supports transparent decompression of compressed files using decmpfs. ボリュームが圧縮ファイルの透過的な（意識する必要のない）解凍をdecmpfsを使ってサポートするならば、true。

var volumeSupportsExclusiveRenaming: Bool?

A Boolean value that indicates whether the volume warns of a pre-existing destination when renaming a file. あるブール値、それはボリュームがファイルを改名する時にある前から存在する行き先があると警告するかどうかを指し示します。

var volumeSupportsExtendedSecurity: Bool?

true if the volume implements extended security (ACLs). ボリュームが拡張セキュリティ（ACL）を実装するならば、true。

var volumeSupportsFileCloning: Bool?

A Boolean value that indicates whether the volume supports file cloning. あるブール値、それはボリュームがファイルのクローンをサポートするかどうかを指し示します。

var volumeSupportsHardLinks: Bool?

true if the volume format supports hard links. ボリューム形式がハードリンクをサポートするならば、true。

var volumeSupportsImmutableFiles: Bool?

A Boolean value that indicates whether the volume supports making files immutable. あるブール値、それはボリュームがファイルを不変にすることをサポートするかどうかを指し示します。

var volumeSupportsJournaling: Bool?

true if the volume format supports a journal used to speed recovery in case of unplanned restart (such as a power outage or crash). This does not necessarily mean the volume is actively using a journal. ボリューム形式が予想外の再始動（たとえば停電または故障）の場合において素早く復旧するのに使われるジャーナルをサポートするならば、true。これは必ずしもそのボリュームが能動的にジャーナルを使っていることを意味しません。

var volumeSupportsPersistentIDs: Bool?

true if the volume format supports persistent object identifiers and can look up file system objects by their IDs. ボリューム形式が永続オブジェクト識別子をサポートするそしてファイルシステムオブジェクトをそれらのIDによって検索できるならば、true。

var volumeSupportsRenaming: Bool?

true if the volume can be renamed. ボリュームが改名されることが可能ならば、ture。

var volumeSupportsRootDirectoryDates: Bool?

true if the volume supports reliable storage of times for the root directory. ボリュームがルートディレクトリに対して時間に関して信頼できるストレージをサポートするならば、true。

var volumeSupportsSparseFiles: Bool?

true if the volume format supports sparse files, that is, files which can have ‘holes’ that have never been written to, and thus do not consume space on disk. A sparse file may have an allocated size on disk that is less than its logical length. ボリューム形式がスパースファイル、すなわち、一度もそれへと書き込まれたことまない ‘穴’ を持つことができる、そしてそれゆえディスク上の空間を浪費しないファイル、をサポートするならば、true。スパースファイルは、それの論理的長さより少ないある割り当てサイズをディスク上でもつかもしれません。

var volumeSupportsSwapRenaming: Bool?

A Boolean value that indicates whether the volume supports swapping source and target files when both exist. あるブール値、それはボリュームがソースおよびターゲットファイルを両方が存在する場合に交換することをサポートするかどうかを指し示します。

var volumeSupportsSymbolicLinks: Bool?

true if the volume format supports symbolic links. ボリューム形式がシンボリックリンクをサポートするならば、true。

var volumeSupportsVolumeSizes: Bool?

true if the volume supports returning volume size values (volumeTotalCapacity and volumeAvailableCapacity). ボリュームがボリュームサイズ値volumeTotalCapacityおよびvolumeAvailableCapacity）を返すことをサポートするならば、true。

var volumeSupportsZeroRuns: Bool?

For security reasons, parts of a file (runs) that have never been written to must appear to contain zeroes. true if the volume keeps track of allocated but unwritten runs of a file so that it can substitute zeroes without actually writing zeroes to the media. 安全上の理由のために、それへと一度も書き込まれないファイル（実行）の部分がゼロを含むように見えなければなりません。ボリュームがあるファイルのアロケートされるしかし書き込まれない実行の情報を得続けるならばtrue、そうすることでそれは実際にメディアにゼロを書き込むことなしにゼロを代用できます。

var volumeURLForRemounting: URL?

The URL needed to remount a network volume, or nil if not available. ネットワークボリュームを再マウントするのに必要とされるURL、または利用可能でないならばnil。

var volumeUUIDString: String?

The volume’s persistent UUID as a string, or nil if a persistent UUID is not available for the volume. ボリュームのもつ永続UUIDを文字列として、または永続UUIDがボリュームにとって利用可能でないならばnil。

Ubiquitous Values ユビキタス値

var isUbiquitousItem: Bool?

true if this item is synced to the cloud, false if it is only a local file. この項目がクラウドと同期されるならばtrue、それがローカルファイルのみならばfalse。

var ubiquitousItemIsShared: Bool?

var ubiquitousSharedItemCurrentUserPermissions: URLUbiquitousSharedItemPermissions?

var ubiquitousSharedItemCurrentUserRole: URLUbiquitousSharedItemRole?

var ubiquitousSharedItemMostRecentEditorNameComponents: PersonNameComponents?

var ubiquitousSharedItemOwnerNameComponents: PersonNameComponents?

var ubiquitousItemContainerDisplayName: String?

returns the name of this item’s container as displayed to users. この項目のもつコンテナの名前をユーザに表示されるとおりに返します。

var ubiquitousItemDownloadRequested: Bool?

returns whether a download of this item has already been requested with an API like startDownloadingUbiquitousItem(at:) throws. この項目のダウンロードが既にstartDownloadingUbiquitousItem(at:) throwsのようなAPIでリクエストされたかどうかを返します。

var ubiquitousItemDownloadingError: NSError?

returns the error when downloading the item from iCloud failed, see the NSUbiquitousFile section in FoundationErrors.h iCloudからの項目のダウンロードが失敗したならばエラーを返します、NSUbiquitousFileの節をFoundationErrors.hにおいて見てください。

var ubiquitousItemDownloadingStatus: URLUbiquitousItemDownloadingStatus?

returns the download status of this item. この項目のダウンロート状態を返します。

var ubiquitousItemHasUnresolvedConflicts: Bool?

true if this item has conflicts outstanding. この項目が未解決の衝突を持つならば、true。

var ubiquitousItemIsDownloading: Bool?

true if data is being downloaded for this item. データがこの項目に対してダウンロードされているところならば、true。

var ubiquitousItemIsUploaded: Bool?

true if there is data present in the cloud for this item. この項目に対してクラウドに存在するデータがあるならば、true。

var ubiquitousItemIsUploading: Bool?

true if data is being uploaded for this item. データがこの項目に対してアップロードされているところならば、true。

var ubiquitousItemUploadingError: NSError?

returns the error when uploading the item to iCloud failed, see the NSUbiquitousFile section in FoundationErrors.h iCloudへの項目のアップロードが失敗したならばエラーを返します、NSUbiquitousFileの節をFoundationErrors.hにおいて見てください。

Thumbnail Values サムネール値

var thumbnail: NSImage?

A thumbnail image of the URL. URLのサムネール画像。

var thumbnailDictionary: [URLThumbnailDictionaryItem : UIImage]?

A dictionary of UIKit image objects keyed by size. 大きさによってキー付けされるUIKit画像オブジェクトそれらからなるある辞書。

var thumbnailDictionary: [URLThumbnailDictionaryItem : NSImage]?

A dictionary of AppKit image objects keyed by size. 大きさによってキー付けされるAppKitオブジェクトそれらからなるある辞書。

Universal Resource Values ユニバーサルリソース値

var addedToDirectoryDate: Date?

The date the resource was created, or renamed into or within its parent directory. それの親ディレクトリへとまたは内部にリソースが作成された、または改名された日付。

var allValues: [URLResourceKey : Any]

A loosely-typed dictionary containing all keys and values. 全てのキーと値を含んでいる遅延型付けされた辞書。

var attributeModificationDate: Date?

The time the resource’s attributes were last modified. リソースのもつ属性が最後に修正された時間。

var canonicalPath: String?

The URL’s path as a canonical absolute file system path. URLのもつパス、正準絶対ファイルシステムパスとして。

var contentAccessDate: Date?

The date the resource was last accessed. リソースが最後にアクセスされた日付。

var contentModificationDate: Date?

The time the resource content was last modified. リソース内容が最後に修正された時間。

var creationDate: Date?

The date the resource was created. リソースが作成された日付。

var customIcon: NSImage?

var effectiveIcon: AnyObject?

var generationIdentifier: (NSCopying & NSSecureCoding & NSObjectProtocol)?

An opaque generation identifier which can be compared using == to determine if the data in a document has been modified. 不透明生成識別子、それは==を使って比較されて書類の中のデータが修正されたかどうか決定できます。

var hasHiddenExtension: Bool?

True for resources whose filename extension is removed from the localized name property. それのファイル名拡張子がローカライズされた名前プロパティから取り除かれるリソースに対してtrue。

var isAliasFile: Bool?

true if the resource is a Finder alias file or a symlink, false otherwise リソースがFinderエイリアスファイルまたはシンボリックリンクならばtrue、そうでなければfalse。

var isExcludedFromBackup: Bool?

True if resource should be excluded from backups, false otherwise. リソースがバックアップから除外されるべきならばtrue、そうでなければfalse。

var isHidden: Bool?

True for resources normally not displayed to users. 普通にユーザに表示されなかったリソースに対してtrue。

var isPackage: Bool?

True for packaged directories. パッケージディレクトリに対してtrue。

var isReadable: Bool?

True if this process (as determined by EUID) can read the resource. このプロセス（EUIDによって決定される）がリソースを読み出し可能ならば、true。

var isSymbolicLink: Bool?

True for symlinks. シンボリックリンクに対してtrue。

var isSystemImmutable: Bool?

True for system-immutable resources. システム不変のリソースに対してtrue。

var isUserImmutable: Bool?

True for user-immutable resources ユーザ不変のリソースに対してtrue。

var isWritable: Bool?

True if this process (as determined by EUID) can write to the resource. このプロセス（EUIDによって決定される）がリソースに書き出し可能ならば、true。

var labelColor: NSColor?

var labelNumber: Int?

The label number assigned to the resource. リソースに割り当てられるラベル番号。

var linkCount: Int?

Number of hard links to the resource. そのリソースに対するハードリンクの数。

var localizedLabel: String?

The user-visible label text. ユーザが見ることができるラベルテキスト。

var localizedName: String?

Localized or extension-hidden name as displayed to users. ローカライズされたまたは拡張子が隠された名前、ユーザに表示されるとおりに。

var localizedTypeDescription: String?

User-visible type or “kind” description. ユーザが見ることができる型または “種類” 記述。

var name: String?

The resource name provided by the file system. ファイルシステムによって提供されるリソース名。

var parentDirectory: URL?

The resource’s parent directory, if any. リソースのもつ親ディレクトリ、もしあれば。

var path: String?

The URL’s path as a file system path. URLのもつパス、ファイルシステムパスとして。

var preferredIOBlockSize: Int?

The optimal block size when reading or writing this file’s data, or nil if not available. このファイルのもつデータを読み出すまたは書き出す場合に最適ブロックサイズ、または利用可能でないならばnil。

var quarantineProperties: [String : Any]?

The quarantine properties as defined in LSQuarantine.h. To remove quarantine information from a file, pass nil as the value when setting this property. 隔離プロパティ、LSQuarantine.hにおいて定義されるとおりに。隔離情報をファイルから取り除くには、nilを値としてこのプロパティを設定している時に渡してください。

var tagNames: [String]?

The array of Tag names. 「タグ」名からなる配列。

var typeIdentifier: String?

A string that represents the identifier for the type of the resource. ある文字列、それはリソースの型に対する識別子を表します。

var contentType: UTType?

The resource’s type. リソースのもつ型。