getPromisedItemResourceValue(_:forKey:)

func getPromisedItemResourceValue(_ value: AutoreleasingUnsafeMutablePointer<AnyObject?>, 
                           forKey key: URLResourceKey) throws

Return Value 戻り値

true if value is successfully populated; otherwise, false. true、もしvalueがうまく収められたならば、そうでなければfalse。

Discussion 議論

This method behaves identically to getResourceValue(_:forKey:), but works on promised items. A promised item is not guaranteed to have its contents in the file system until you use a file coordinator to perform a coordinated read on its URL, which causes the contents to be downloaded or otherwise generated. Promised item URLs are returned by various APIs, including: このメソッドはgetResourceValue(_:forKey:)とまったく同じに振るまいます、しかしプロミス項目で働きます。プロミス項目は、それの内容をファイルシステムの中に持つことを保証されません、あなたがファイルコーディネータを使って協調読み込みをそれのURL上で実行するまでは、それはその内容がダウンロードされるかそうでなければ生成されることを引き起こします。プロミス項目URLは、様々なAPIによって返され、以下を含んでいます：

• A metadata query using either the NSMetadataQueryUbiquitousDataScope or NSMetadataQueryUbiquitousDocumentsScope scopes NSMetadataQueryUbiquitousDataScopeまたはNSMetadataQueryUbiquitousDocumentsScope作用域のどちらかを使っているメタデータクエリ

• The contents of the directory returned by the file manager’s URLForUbiquitousContainerIdentifier: ファイルマネージャの持つURLForUbiquitousContainerIdentifier:によって返されるディレクトリの内容

• The URL inside the accessor block of a coordinated read or write operation that used the immediatelyAvailableMetadataOnly, forDeleting, forMoving, or contentIndependentMetadataOnly options immediatelyAvailableMetadataOnly、forDeleting、forMoving、またはcontentIndependentMetadataOnlyオプションを使用した協調読み込みまたは書き込み演算のアクセッサブロック内部のURL

You must use this method instead of getResourceValue:forKey:error: for any URLs returned by these methods. あなたは、このメソッドを、getResourceValue:forKey:error:の代わりに、これらのメソッドによって返されるあらゆるURLに対して使わなければなりません。

This method works for any resource value that is not tied to the item’s contents. Some keys, like contentAccessDateKey or generationIdentifierKey, do not return valid values. If you use one of these keys, the method returns true, but the value returns nil. このメソッドは、項目の持つ内容に紐付けられない何らかのリソース値に対して働きます。いくつかのキーは、contentAccessDateKeyまたはgenerationIdentifierKeyのように、有効な値を返しません。あなたがこれらのキーの１つを使うならば、メソッドはtrueを返します、しかし値はnilを返します。