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

attributesOfItemAtPath:error:

Returns the attributes of the item at a given path. 与えられたパスでの項目の属性を返します。

Declaration 宣言

- (NSDictionary<NSFileAttributeKey, id> *)attributesOfItemAtPath:(NSString *)path 
                                                           error:(NSError * _Nullable *)error;

Parameters パラメータ

path

The path of a file or directory. ファイルまたはディレクトリのパス。

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 戻り値

An NSDictionary object that describes the attributes (file, directory, symlink, and so on) of the file specified by path, or nil if an error occurred. The keys in the dictionary are described in File Attribute Keys. あるNSDictionaryオブジェクト、それはpathによって指定されたファイルの属性(ファイル、ディレクトリ、symlink、など)を記述します、またはnil、もしエラーが発生したならば。辞書の中のキーは、File Attribute Keysにおいて記述されます。

Discussion 議論

If the item at the path is a symbolic link—that is, the value of the NSFileType key in the attributes dictionary is NSFileTypeSymbolicLink—you can use the destinationOfSymbolicLinkAtPath:error: method to retrieve the path of the item pointed to by the link. You can also use the stringByResolvingSymlinksInPath method of NSString to resolve links in the path before retrieving the item’s attributes. パスでの項目がシンボリックリンクである — すなわち、属性辞書の中のNSFileTypeキーの値がNSFileTypeSymbolicLinkである — ならば、あなたはdestinationOfSymbolicLinkAtPath:error:メソッドを使ってそのリンクによって指し示される項目のパスを得ることができます。あなたはまた、NSStringstringByResolvingSymlinksInPathメソッドを使ってパスの中のリンクを、項目の持つ属性を回収する前に解決できます。

As a convenience, NSDictionary provides a set of methods (declared as a category on NSDictionary) for quickly and efficiently obtaining attribute information from the returned dictionary: fileGroupOwnerAccountName, fileModificationDate, fileOwnerAccountName, filePosixPermissions, fileSize, fileSystemFileNumber, fileSystemNumber, and fileType. ひとつの便宜として、NSDictionaryは一揃いのメソッド(NSDictionary上のあるカテゴリとして宣言される)を返される辞書から属性情報を素早く効率的に取得するために提供します:fileGroupOwnerAccountName, fileModificationDate, fileOwnerAccountName, filePosixPermissions, fileSize, fileSystemFileNumber, fileSystemNumber, そして fileType

Discussion 議論

See Also 参照

Getting and Setting Attributes 属性の取得と設定