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

subpaths(atPath:)

Returns an array of strings identifying the paths for all items in the specified directory. 指定されたディレクトリの中の全ての項目に対するパスを識別する文字列の配列を返します。

Declaration 宣言 

func subpaths(atPath path: String) -> [String]?

Parameters パラメータ

path

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

Return Value 戻り値

An array of NSString objects, each of which contains the path of an item in the directory specified by path. If path is a symbolic link, this method traverses the link. This method returns nil if it cannot retrieve the device of the linked-to file. NSStringオブジェクトからなる配列、そのそれぞれはpathによって指定されるディレクトリの中のある項目のパスを含んでいます。pathがシンボリックリンクならば、このメソッドはそのリンクを辿ります。このメソッドは、それがリンクされたファイルのデバイスを取ってくることができないならば、nilを返します。

Discussion 議論

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

This method reveals every element of the subtree at path, including the contents of file packages (such as apps, nib files, and RTFD files). This code fragment gets the contents of /System/Library/Fonts after verifying that the directory exists: このメソッドは、pathでの下位ツリーのすべての要素を明らかにします、ファイルパッケージの内容を含めて（例えばアプリ、nibファイル、そしてRTFDファイルなど）。このコード断片は、/System/Library/Fontsの内容を、そのディレクトリが存在することを検証した後に取得します： 


BOOL isDir = NO;
NSArray *subpaths;
NSString *fontPath = @"/System/Library/Fonts";
NSFileManager *fileManager = [[NSFileManager alloc] init];
if ([fileManager fileExistsAtPath:fontPath isDirectory:&isDir] && isDir)
    subpaths = [fileManager subpathsAtPath:fontPath];

Special Considerations 特別な注意事項

In macOS 10.5 and later, use subpathsOfDirectory(atPath:) instead. macOS 10.5以降では、subpathsOfDirectory(atPath:)を代わりに使ってください。

See Also 参照

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

func contentsOfDirectory(at: URL, includingPropertiesForKeys: [URLResourceKey]?, options: FileManager.DirectoryEnumerationOptions) -> [URL]
Performs a shallow search of the specified directory and returns URLs for the contained items. 指定されたディレクトリの浅い検索を実行して、含まれる項目に対するURLを返します。
func contentsOfDirectory(atPath: String) -> [String]
Performs a shallow search of the specified directory and returns the paths of any contained items. 指定されたディレクトリの浅い検索を実行して、あらゆる含まれる項目のパスを返します。
func enumerator(at: URL, includingPropertiesForKeys: [URLResourceKey]?, options: FileManager.DirectoryEnumerationOptions, errorHandler: ((URL, Error) -> Bool)?) -> FileManager.DirectoryEnumerator?
Returns a directory enumerator object that can be used to perform a deep enumeration of the directory at the specified URL. 指定されたURLでのディレクトリの深い列挙を実行するために使用できるディレクトリ列挙子オブジェクトを返します。
func enumerator(atPath: String) -> FileManager.DirectoryEnumerator?
Returns a directory enumerator object that can be used to perform a deep enumeration of the directory at the specified path. 指定されたパスでのディレクトリの深い列挙を実行するために使用できるディレクトリ列挙子オブジェクトを返します。
class FileManager.DirectoryEnumerator
An object that enumerates the contents of a directory. あるディレクトリの内容を列挙するオブジェクト。
func mountedVolumeURLs(includingResourceValuesForKeys: [URLResourceKey]?, options: FileManager.VolumeEnumerationOptions) -> [URL]?
Returns an array of URLs that identify the mounted volumes available on the device. デバイス上で利用可能なマウントされたボリュームを識別するURLの配列を返します。
struct FileManager.VolumeEnumerationOptions
Options for enumerating mounted volumes with the mountedVolumeURLs(includingResourceValuesForKeys:options:) method. マウントされたボリュームをmountedVolumeURLs(includingResourceValuesForKeys:options:)メソッドで列挙することに対するオプション。
func subpathsOfDirectory(atPath: String) -> [String]
Performs a deep enumeration of the specified directory and returns the paths of all of the contained subdirectories. 指定されたディレクトリの深い列挙を実行します、そして全ての含まれる下位ディレクトリのパスを返します。