Instance Method インスタンスメソッド

getRelationship:ofDirectory:inDomain:toItemAtURL:error:

Determines the type of relationship that exists between a system directory and the specified item. システムディレクトリと指定された項目の間に存在する関係の型を決定します。

Declaration 宣言 

- (BOOL)getRelationship:(NSURLRelationship *)outRelationship 
            ofDirectory:(NSSearchPathDirectory)directory 
               inDomain:(NSSearchPathDomainMask)domainMask 
            toItemAtURL:(NSURL *)url 
                  error:(NSError * _Nullable *)error;

Parameters パラメータ

outRelationship

A pointer to a variable in which to put the relationship between directoryURL and otherURL. For a list of possible values, see NSURLRelationship. directoryURLとotherURLとの間の関係が置かれることになる変数へのポインタ。可能な値のリストとして、NSURLRelationshipを見てください。

directory

The search path directory. For a list of possible values, see NSSearchPathDirectory. 検索パスディレクトリ。可能な値の一覧として、NSSearchPathDirectoryを見てください。

domainMask

The file system domain to search. Specify 0 for this parameter if you want the file manager to choose the domain that is most appropriate for the specified url. 検索するファイルシステムドメイン。0をこのパラメータに対して指定してください、もしあなたが指定されたurlに対して最も適切であるドメインを選ぶために、ファイルマネージャを望むならば。

url

The URL of the file or directory whose relationship to directoryURL is being tested. This parameter must not be nil. ファイルまたはディレクトリのURL、それのdirectoryURLへの関係がテストされています。このパラメータは、nilであってはいけません。

error

On input, a pointer to an error object. If an error occurs, this pointer is set to an actual error object containing the error information. You may specify nil for this parameter if you do not want the error information. 入力では、エラーオブジェクトへのポインタ。エラーが発生するならば、このポインタはエラー情報を含んでいる実際のエラーオブジェクトへと設定されます。あなたは、nilをこのパラメータに対して指定するかもしれません、もしあなたがエラー情報を望まないならば。

Return Value 戻り値

YES if the relationship between the items was successfully determined, or NO if an error occurred. YES、もし項目間の関係がうまく決定されたならば、またはNO、もしエラーが発生したならば。

Discussion 議論

Use this method to determine the relationship between an item and one of the system-specific directories. For example, you might use this method to determine if the specified item is in the user’s Documents directory or is in the trash. If the relationship between the items is determined successfully, this method sets the value of the outRelationship parameter to an appropriate value and returns YES. The directory may contain the item, it may be the same as the item, or it may not have a direct relationship to the item. このメソッドを使って、ある項目とシステム固有ディレクトリの１つと間の関係を決定してください。例えば、あなたはこのメソッドを使って、指定された項目がユーザのDocumentsディレクトリの中にあるまたはゴミ箱の中にあるかを決定するかもしれません。項目間の関係がうまく決定されるならば、このメソッドはoutRelationshipパラメータの値を適切な値に設定して、YESを返します。ディレクトリはその項目を含むかもしれません、それはその項目と同じかもしれません、またはそれはその項目に対して直接の関係を持たないかもしれません。

See Also 参照

Getting the Relationship Between Items 項目間の関係を取得する

- getRelationship:ofDirectoryAtURL:toItemAtURL:error:
Determines the type of relationship that exists between a directory and an item. あるディレクトリとある項目の間に存在する関係の型を決定します。
NSURLRelationship
Constants indicating the relationship between a directory and an item. あるディレクトリとある項目の間の関係を指し示す定数。