Instance Method
インスタンスメソッド
contentsOfDirectoryAtPath:error:
Performs a shallow search of the specified directory and returns the paths of any contained items.
指定されたディレクトリの浅い検索を実行して、あらゆる含まれる項目のパスを返します。
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
ディレクトリ内容を発見する
- enumeratorAtPath:
Returns a directory enumerator object that can be used to perform a deep enumeration of the directory at the specified path.
指定されたパスでのディレクトリの深い列挙を実行するために使用できるディレクトリ列挙子オブジェクトを返します。
- subpathsOfDirectoryAtPath:error:
Performs a deep enumeration of the specified directory and returns the paths of all of the contained subdirectories.
指定されたディレクトリの深い列挙を実行します、そして全ての含まれる下位ディレクトリのパスを返します。
- subpathsAtPath:
Returns an array of strings identifying the paths for all items in the specified directory.
指定されたディレクトリの中の全ての項目に対するパスを識別する文字列の配列を返します。
Related Documentation
関連文書
- fileExistsAtPath:isDirectory:
Returns a Boolean value that indicates whether a file or directory exists at a specified path.
ファイルまたはディレクトリが指定されたパスで存在するかどうかを指し示すブール値を返します。