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

url(for:in:appropriateFor:create:)

Locates and optionally creates the specified common directory in a domain. あるドメインにおいて、指定される一般的ディレクトリの位置を突き止めて、任意に作成します。

Declaration 宣言

func url(for directory: FileManager.SearchPathDirectory, 
      in domain: FileManager.SearchPathDomainMask, 
appropriateFor url: URL?, 
  create shouldCreate: Bool) throws -> URL

Parameters パラメータ

directory: The search path directory. The supported values are described in FileManager.SearchPathDirectory. 検索パスディレクトリ。サポートされる値は、FileManager.SearchPathDirectoryで記述されます。
domain: The file system domain to search. The value for this parameter is one of the constants described in FileManager.SearchPathDomainMask. You should specify only one domain for your search and you may not specify the allDomainsMask constant for this parameter. 検索するファイルシステムドメイン。このパラメータの値は、FileManager.SearchPathDomainMaskで記述される定数の１つです。あなたは、ただ１つのドメインだけをあなたの検索に対して指定すべきです、そしてあなたはallDomainsMask定数をこのパラメータに対して指定しないでしょう。
url: The file URL used to determine the location of the returned URL. Only the volume of this parameter is used. 返されるURLの位置を決定するために使われるファイルURL。このパラメータのボリューム名だけが使われます。

This parameter is ignored unless the directory parameter contains the value FileManager.SearchPathDirectory.itemReplacementDirectory and the domain parameter contains the value userDomainMask. このパラメータは、directoryパラメータが値FileManager.SearchPathDirectory.itemReplacementDirectoryを含むそしてdomainパラメータが値userDomainMaskを含む場合を除いて、無視されます。
shouldCreate: Whether to create the directory if it does not already exist. それがまだ存在しないならば、ディレクトリを作成するかどうか。

When creating a temporary directory, this parameter is ignored and the directory is always created. 一時ディレクトリを作成する場合、このパラメータは無視されます、そしてディレクトリは常に作成されます。

Return Value 戻り値

The NSURL for the requested directory. 要請されたディレクトリに対するNSURL。

Discussion 議論

You typically use this method to locate one of the standard system directories, such as the Documents, Application Support or Caches directories. After locating (or creating) the desired directory, this method returns the URL for that directory. If more than one appropriate directory exists in the specified domain, this method returns only the first one it finds. あなたは、概してこのメソッドを使って標準システムディレクトリの１つの位置を突き止めます、例えばDocuments、Application SupportまたはCachesディレクトリなど。望むディレクトリの位置を突き止めた後、このメソッドはそのディレクトリに対するURLを返します。複数の適したディレクトリが指定されたドメインに存在するならば、このメソッドは、それが見つけた最初のもののみを返します。

You can use this method to create a new temporary directory. To do so, specify FileManager.SearchPathDirectory.itemReplacementDirectory for the directory parameter, userDomainMask for the domain parameter, and a URL for the url parameter which determines the volume of the returned URL. あなたは、このメソッドを使って新しい一時ディレクトリを作成できます。そうするには、FileManager.SearchPathDirectory.itemReplacementDirectoryをdirectoryパラメータに、userDomainMaskをdomainパラメータに、そしてあるURLを、返されるURLのボリュームを決定するurlパラメータに指定してください。

For example, the following code results in a new temporary directory with a path in the form of /private/var/folders/d0/h37cw8ns3h1bfr_2gnwq2yyc0000gn/T/TemporaryItems/Untitled/: 例えば、以下のコードは、/private/var/folders/d0/h37cw8ns3h1bfr_2gnwq2yyc0000gn/T/TemporaryItems/Untitled/の形式でのパスをもつ新しい一時ディレクトリという結果になります：

let desktop = URL(fileURLWithPath: "/Users/jappleseed/Desktop/")


do {
    let temporaryDirectory = try FileManager.default.url(
        for: .itemReplacementDirectory,
        in: .userDomainMask,
        appropriateFor: desktop,
        create: true
    )
    
    print(temporaryDirectory)
} catch {
    // Handle the error.
}

Handling Errors in Swift: Swiftでのエラー処理：

In Swift, this method returns a nonoptional result and is marked with the throws keyword to indicate that it throws an error in cases of failure. Swiftでは、このメソッドは非オプショナルの結果を返します、そしてthrowsキーワードで印されて失敗の場合にそれがエラーをスローすることを指し示します。

You call this method in a try expression and handle any errors in the catch clauses of a do statement, as described in Error Handling in The Swift Programming Language and About Imported Cocoa Error Parameters. あなたはこのメソッドをtry式の中で呼び出して、あらゆるエラーをdo文のcatch節で取り扱います、The Swift Programming Languageのエラー処理そしてインポートされるCocoaエラーパラメータについてで記述されるように。