enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:

Return Value 戻り値

An directory enumerator object that enumerates the contents of the directory at url. If url is a filename, the method returns an enumerator object that enumerates no files—the first call to nextObject returns nil. あるディレクトリ列挙子オブジェクト、それはurlでのディレクトリの内容を列挙します。urlがファイル名ならば、このメソッドはまったくファイルを列挙しない列挙子オブジェクトを返します — nextObjectへの最初の呼び出しはnilを返します。

Discussion 議論

Because the enumeration is deep—that is, it lists the contents of all subdirectories—this enumerator object is useful for performing actions that involve large file-system subtrees. If the method is passed a directory on which another file system is mounted (a mount point), it traverses the mount point. This method does not resolve symbolic links or mount points encountered in the enumeration process, nor does it recurse through them if they point to a directory. 列挙は深くまで達することから — すなわち、それは下位ディレクトリの内容を一覧にします — この列挙子オブジェクトは多数のファイルシステム下位ツリーを伴うさまざまな動作を実行するのに有用です。メソッドがそこにおいて別のファイルシステムがマウントされるディレクトリ（マウントポイント）を渡されるならば、それはそのマウントポイントを辿っていきます。このメソッドは、列挙する過程において出くわすシンボリックリンクまたはマウントポイントそれらを解決しませんし、それらがディレクトリを指すならばそれらを通して再帰もしません。

For example, if you pass a URL that points to /Volumes/MyMountedFileSystem, the returned enumerator will include the entire directory structure for the file system mounted at that location. If, on the other hand, you pass /Volumes, the returned enumerator will include /Volumes/MyMountedFileSystem as one of its results, but will not traverse into the file system mounted there. 例えば、あなたが/Volumes/MyMountedFileSystemを示すURLを渡すならば、返される列挙子は、その場所でマウントされるファイルシステムのディレクトリ構造体全体を含むでしょう。他方、あなたが/Volumesを渡すならば、返される列挙子は/Volumes/MyMountedFileSystemをそれの結果の１つとして含むでしょう、しかしそこでマウントされるファイルシステムの中へと辿っていきません。

The NSDirectoryEnumerator class has methods for skipping descendants of the existing path and for returning the number of levels deep the current object is in the directory hierarchy being enumerated (where the directory passed to enumeratorAtURL:includingPropertiesForKeys:options:errorHandler: is considered to be level 0). NSDirectoryEnumeratorクラスは、既存のパスの子孫をとばして省くためにそして現在のオブジェクトがある列挙されているディレクトリ階層中での深さの水準数を返すためにメソッドを持ちます（そこでenumeratorAtURL:includingPropertiesForKeys:options:errorHandler:に渡されるディレクトリは水準０とみなされます。

This code fragment enumerates a URL and its subdirectories, collecting the URLs of files (skips directories). It also demonstrates how to ignore the contents of specified directories, in this case directories named “_extras”. このコード断片はあるURLとそれの下位ディレクトリを列挙して、ファイルのURLを収集します（ディレクトリをとばします）。それはまた指定されたディレクトリ、この場合 “_extras” と名前をつけられるディレクトリの内容を無視する方法を実演します。

NSURL *directoryURL = [[NSBundle mainBundle] bundleURL];
NSFileManager *localFileManager= [[NSFileManager alloc] init];
NSDirectoryEnumerator *directoryEnumerator =
   [localFileManager enumeratorAtURL:directoryURL
          includingPropertiesForKeys:@[NSURLNameKey, NSURLIsDirectoryKey]
                             options:NSDirectoryEnumerationSkipsHiddenFiles
                        errorHandler:nil];
 
NSMutableArray<NSURL *> *mutableFileURLs = [NSMutableArray array];
for (NSURL *fileURL in directoryEnumerator) {
    NSNumber *isDirectory = nil;
    [fileURL getResourceValue:&isDirectory forKey:NSURLIsDirectoryKey error:nil];
 
    if ([isDirectory boolValue]) {
        NSString *name = nil;
        [fileURL getResourceValue:&name forKey:NSURLNameKey error:nil];
 
        if ([name isEqualToString:@"_extras"]) {
            [directoryEnumerator skipDescendants];
        } else {
            [mutableFileURLs addObject:fileURL];
        }
    }
}
 
NSLog(@"Files: %@", mutableFileURLs);