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

contentsOfDirectoryAtPath:error:

Performs a shallow search of the specified directory and returns the paths of any contained items. 指定されたディレクトリの浅い検索を実行して、あらゆる含まれる項目のパスを返します。

Declaration 宣言

- (NSArray<NSString *> *)contentsOfDirectoryAtPath:(NSString *)path 
                                             error:(NSError * _Nullable *)error;

Parameters パラメータ

path

The path to the directory whose contents you want to enumerate. それの内容をあなたが列挙するのを望むディレクトリへのパス。

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 array of NSString objects, each of which identifies a file, directory, or symbolic link contained in path. Returns an empty array if the directory exists but has no contents. If an error occurs, this method returns nil and assigns an appropriate error object to the error parameter. NSStringオブジェクトからなる配列、そのそれぞれはpathに含まれるファイル、ディレクトリ、またはシンボリックリンクを識別します。ディレクトリが存在するが内容を持たないならば、空の配列を返します。エラーが発生するならば、このメソッドはnilを返して、適切なエラーオブジェクトをerrorパラメータに割り当てます。

Discussion 議論

This method performs a shallow search of the directory and therefore does not traverse symbolic links or return the contents of any subdirectories. This method also does not return URLs for the current directory (“.”), parent directory (“..”), or resource forks (files that begin with “._”) but it does return other hidden files (files that begin with a period character). If you need to perform a deep enumeration, use the enumeratorAtURL:includingPropertiesForKeys:options:errorHandler: method instead. このメソッドは、ディレクトリの浅い検索を実行します、そしてそれゆえにシンボリックリンクを辿りません、またあらゆる下位ディレクトリの内容を返しません。このメソッドはまた、現在のディレクトリ(“.”)、親ディレクトリ(“..”)、またはリソークフォーク(“._” で始まるファイル)のURLを返しません、しかしそれは他の不可視ファイルを返します(1つのピリオド文字で始まるファイル)。深い列挙の実行を必要とするならば、enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:メソッドを代わりに使ってください。

The order of the files in the returned array is undefined. 返される配列の中のファイルの順番は、未定義です。

See Also 参照

Discovering Directory Contents ディレクトリ内容を発見する

Related Documentation 関連文書