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

subpathsOfDirectoryAtPath:error:

Performs a deep enumeration of the specified directory and returns the paths of all of the contained subdirectories. 指定されたディレクトリの深い列挙を実行します、そして全ての含まれる下位ディレクトリのパスを返します。

Declaration 宣言

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

Parameters パラメータ

path

The path of the directory to list. 一覧にするディレクトリのパス。

error

If an error occurs, upon return contains an NSError object that describes the problem. Pass NULL if you don’t want error information. エラーが発生するならば、戻りでは、問題を記述するNSErrorオブジェクトを含みます。NULLをあなたがエラー情報を望まないならば渡してください。

Return Value 戻り値

An array of strings, each containing the path of an item in the directory specified by path, or nil if an error occurred. それぞれがpathによって指定されたディレクトリの中の項目のパスを含んでいる文字列からなる配列、またはnil、もしエラーが発生したならば。

Discussion 議論

This method recurses the specified directory and its subdirectories. The method skips the “.” and “..” directories at each level of the recursion. このメソッドは、指定されたディレクトリとそれの下位ディレクトリを再帰します。このメソッドは、“.” と “..” ディレクトリを再帰の各水準でスキップします。

Because this method recurses the directory’s contents, you might not want to use it in performance-critical code. Instead, consider using the enumeratorAtURL:includingPropertiesForKeys:options:errorHandler: or enumeratorAtPath: method to enumerate the directory contents yourself. Doing so gives you more control over the retrieval of items and more opportunities to complete the enumeration or perform other tasks at the same time. このメソッドはディレクトリの内容を再帰することから、あなたは性能重視のコードにおいてそれを使おうと思わないかもしれません。代わりに、enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:またはenumeratorAtPath:メソッドを使ってあなた自身でディレクトリ内容を列挙することを考えてください。そうすることは、あなたに項目の検索にわたってさらなる制御を、そして列挙を完全なものにするまたは他のタスクを同時に実行するさらなる機会を与えます。

See Also 参照

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