Structure

URL

A value that identifies the location of a resource, such as an item on a remote server or the path to a local file. ある値、それはあるリソースの場所を識別します、たとえばリモートサーバー上のある項目またはあるローカルファイルへのパスなど。

Declaration 宣言 

struct URL

Overview 概要

You can construct URLs and access their parts. For URLs that represent local files, you can also manipulate properties of those files directly, such as changing the file’s last modification date. Finally, you can pass URLs to other APIs to retrieve the contents of those URLs. あなたは、URLを組み立てるそしてそれの部分にアクセスすることができます。ローカルファイルを表すURLに対しては、あなたはまたそれらのファイルのプロパティを直接に操作できます、例えばファイルの持つ最終修正日を変更するなど。最終的に、あなたはURLを他のAPIに渡して、それらURLの内容を回収できます。 For example, you can use URLSession and its related classes to access the contents of remote resources.

URLs are the preferred way to refer to local files. Most objects that read data from or write data to a file have methods that accept a URL instead of a pathname as the file reference. URLは、ローカルファイルを参照する好ましい方法です。ファイルからデータを読み出すまたはそれへとデータを書き込むほとんどのオブジェクトは、URLをパス名の代わりにファイル参照として受け入れるメソッドを持ちます。 For example, you can get the contents of a local file URL as String by calling init(contentsOf:encoding:), or as a Data by calling init(contentsOf:options:).

As a convenience, you can use Swift’s async-await syntax to asynchronously access the contents of a URL through the resourceBytes and lines properties. These properties use the shared URLSession instance to load the resoruce.

Topics 話題

Creating a URL from a String URLを文字列から作成する

init?(string: String)
Creates a URL instance from the provided string. URLインスタンスをその提供された文字列から作成します。
init?(string: String, relativeTo: URL?)
Creates a URL instance from the provided string, relative to another URL. URLインスタンスをその提供された文字列から作成します、別のURLに相対して。

Creating a File URL ファイルURLを作成する

init(fileURLWithPath: String)
Creates a file URL that references the local file or directory at path. あるファイルURLを作成します、それはパスでのローカルなファイルまたはディレクトリを参照します。
init(fileURLWithPath: String, isDirectory: Bool)
Creates a file URL that references the local file or directory at path. あるファイルURLを作成します、それはパスでのローカルなファイルまたはディレクトリを参照します。
init(fileURLWithPath: String, relativeTo: URL?)
Creates a file URL that references the local file or directory at path, relative to a base URL. あるファイルURLを作成します、それはパスでのローカルなファイルまたはディレクトリを参照します、ある基盤URLに相対します。
init(fileURLWithPath: String, isDirectory: Bool, relativeTo: URL?)
Creates a file URL that references the local file or directory at path, relative to a base URL. あるファイルURLを作成します、それはパスでのローカルなファイルまたはディレクトリを参照します、ある基盤URLに相対します。
init(fileURLWithFileSystemRepresentation: UnsafePointer<Int8>, isDirectory: Bool, relativeTo: URL?)
Creates a URL that references the local file or directory at the file system representation of the path. あるURLを作成します、それはそのパスのファイルシステム表現でのローカルなファイルまたはディレクトリを参照します。
init(fileReferenceLiteralResourceName: String)
Creates a URL from a playground file literal. あるURLをプレイグラウンドファイルリテラルから作成します。

Creating a URL by Resolving a Bookmark URLをブックマークを解決することによって作成する

init(resolvingBookmarkData: Data, options: URL.BookmarkResolutionOptions, relativeTo: URL?, bookmarkDataIsStale: inout Bool)
Creates a URL that refers to a location specified by resolving bookmark data. ブックマークデータを解決することによって指定されるある場所を参照するURLを作成します。
init(resolvingAliasFileAt: URL, options: URL.BookmarkResolutionOptions)
Creates a URL that refers to the location specified by resolving an alias file. エイリアスファイルを解決することによって指定される場所を参照するURLを作成します。
typealias URL.BookmarkResolutionOptions
An alias for the bookmark resolution options type. ブックマーク解決オプション型に対するエイリアス。
struct NSURL.BookmarkResolutionOptions
Options used when resolving bookmark data. ブックマークデータを解決している時に使われるオプション。

Encoding and Decoding a URL URLをエンコードおよびデコードする

init(from: Decoder)
Creates a URL by decoding an encoded representation. URLをあるエンコードされた表現をデコードすることによって作成します。
func encode(to: Encoder)
Encodes the URL for later decoding. 後でデコードするURLをエンコードする

Working with the Data Representation of a URL URLのデータ表現を扱う

init?(dataRepresentation: Data, relativeTo: URL?, isAbsolute: Bool)
Initializes a newly created URL using the contents of the given data, relative to a base URL. 新しく作成されたURLをこの与えられたデータの内容を使って初期化します、ある基盤URLに相対します。
var dataRepresentation: Data
The data representation of the URL’s relativeString. URLのもつrelativeStringのデータ表現。

Accessing the Parts of a URL URLの部分にアクセスする

var absoluteString: String
The absolute string for the URL. そのURLに対する完全な文字列。
var absoluteURL: URL
The absolute URL. 完全URL。
var baseURL: URL?
The base URL. 基準URL。
var fragment: String?
The fragment component of the URL if the URL conforms to RFC 1808 (the most common form of URL), otherwise nil. URLのフラグメント構成要素、もしそのURLがRFC 1808（URLの最も一般的な形式）に準拠するならば、そうでなければnil。
var host: String?
The host component of a URL if the URL conforms to RFC 1808 (the most common form of URL), otherwise nil. URLのホスト構成要素、もしそのURLがRFC 1808（URLの最も一般的な形式）に準拠するならば、そうでなければnil。
var lastPathComponent: String
The last path component of the URL, or an empty string if the path is an empty string. URLの最後のパス構成要素、またはパスが空文字列ならば空文字列。
var path: String
The path component of the URL if the URL conforms to RFC 1808 (the most common form of URL), otherwise an empty string. URLのパス構成要素、もしそのURLがRFC 1808（URLの最も一般的な形式）に準拠するならば、そうでなければ空文字列。
var pathComponents: [String]
The path components of the URL, or an empty array if the path is an empty string. URLのパス構成要素それら、またはパスが空文字列ならば空文字列。
var pathExtension: String
The path extension of the URL, or an empty string if the path is an empty string. URLのパス拡張子構成要素、またはパスが空文字列ならば空文字列。
var port: Int?
The port component of the URL if the URL conforms to RFC 1808 (the most common form of URL), otherwise nil. URLのポート構成要素、もしそのURLがRFC 1808（URLの最も一般的な形式）に準拠するならば、そうでなければnil。
var query: String?
The query of the URL if the URL conforms to RFC 1808 (the most common form of URL), otherwise nil. URLのクエリ、もしそのURLがRFC 1808（URLの最も一般的な形式）に準拠するならば、そうでなければnil。
var relativePath: String
The relative path of the URL if the URL conforms to RFC 1808 (the most common form of URL), otherwise nil. URLの相対パス、もしそのURLがRFC 1808（URLの最も一般的な形式）に準拠するならば、そうでなければnil。
var relativeString: String
The relative portion of a URL. あるURLの相対部分。
var scheme: String?
The scheme of the URL. URLのスキーム。
var standardized: URL
A version of the URL with any instances of “..” or “.” removed from its path. URLのある変形版、それのパスから “..” または “.” のあらゆる出現を取り除いた状態で。
var standardizedFileURL: URL
A standardized version of the path of a file URL. ファイルURLのパスの標準化バージョン。
var user: String?
The user component of the URL if the URL conforms to RFC 1808 (the most common form of URL), otherwise nil. URLのユーザ構成要素、もしそのURLがRFC 1808（URLの最も一般的な形式）に準拠するならば、そうでなければnil。
var password: String?
The password component of the URL if the URL conforms to RFC 1808 (the most common form of URL), otherwise nil. URLのパスワード構成要素、もしそのURLがRFC 1808（URLの最も一般的な形式）に準拠するならば、そうでなければnil。

Accessing Resource Values リソース値にアクセスする

func resourceValues(forKeys: Set<URLResourceKey>) -> URLResourceValues
Returns a collection of resource values identified by the given resource keys.
func setResourceValues(URLResourceValues)
Sets the resource value identified by a given resource key. 与えられたリソースキーによって識別されるリソース値を設定します。
func removeCachedResourceValue(forKey: URLResourceKey)
Removes the cached resource value identified by a given resource value key from the URL object. 与えられたリソース値キーによって識別されるキャッシュされたリソース値をURLオブジェクトから取り除きます。
func removeAllCachedResourceValues()
Removes all cached resource values and all temporary resource values from the URL object. 全てのキャッシュされたリソース値と全ての一時リソース値をURLオブジェクトから取り除きます。
func setTemporaryResourceValue(Any, forKey: URLResourceKey)
Sets a temporary resource value on the URL object. URLオブジェクト上の一時リソース値を設定します。
struct URLResourceKey
Keys that apply to file system URLs. ファイルシステムURLに適用するキーそれら。
struct URLResourceValues
The properties supported by file system resources. ファイルシステムリソースによってサポートされるプロパティ。

Working with File URLs ファイルURLを扱う

var isFileURL: Bool
A Boolean that is true if the scheme is file:. あるブール値、それはスキームがfile:であるならばtrueです。
var hasDirectoryPath: Bool
A Boolean that is true if the URL path represents a directory. あるブール値、それはURLパスがディレクトリを表すならばtrueです。
func withUnsafeFileSystemRepresentation<ResultType>((UnsafePointer<Int8>?) -> ResultType) -> ResultType
Passes the URL’s path in the file system representation to a closure. URLのもつファイルシステム表現でのパスをあるクロージャに渡します。
func resolveSymlinksInPath()
Resolves any symlinks in the path of a file URL. ファイルURLのパスにおけるあらゆるsymlinkを解決します。
func resolvingSymlinksInPath() -> URL
Resolves any symlinks in the path of a file URL. ファイルURLのパスにおけるあらゆるsymlinkを解決します。
func standardize()
Standardizes the path of a file URL. ファイルURLのパスを標準化します。

Adding Path Components パス構成要素を加える

func appendPathComponent(String)
Appends a path component to the URL. あるパス構成要素をこのURLに追加します。
func appendPathComponent(String, isDirectory: Bool)
Appends a path component to the URL. あるパス構成要素をこのURLに追加します。
func appendingPathComponent(String) -> URL
Returns a URL constructed by appending the given path component to self. 与えられたパス構成要素をselfに追加することによって構築されるURLを返します。
func appendingPathComponent(String, isDirectory: Bool) -> URL
Returns a URL constructed by appending the given path component to self. 与えられたパス構成要素をselfに追加することによって構築されるURLを返します。

Adding a Path Extension パス拡張子を加える

func appendPathExtension(String)
Appends the given path extension to self. 与えられたパス拡張子をselfに追加します。
func appendingPathExtension(String) -> URL
Returns a URL constructed by appending the given path extension to self. 与えられたパス拡張子をselfに追加することによって構築されるURLを返します。

Removing Path Components パス構成要素を取り除く

func deleteLastPathComponent()
Returns a URL constructed by removing the last path component of self. selfの最後のパス構成要素を取り除くことによって構築されるURLを返します。
func deletingLastPathComponent() -> URL
Returns a URL constructed by removing the last path component of self. selfの最後のパス構成要素を取り除くことによって構築されるURLを返します。

Removing a Path Extension パス拡張子を取り除く

func deletePathExtension()
Returns a URL constructed by removing any path extension. 何らかのパス拡張子を取り除くことによって構築されるURLを返します。
func deletingPathExtension() -> URL
Returns a URL constructed by removing any path extension. 何らかのパス拡張子を取り除くことによって構築されるURLを返します。

Creating Bookmarks ブックマークを作成する

func bookmarkData(options: URL.BookmarkCreationOptions, includingResourceValuesForKeys: Set<URLResourceKey>?, relativeTo: URL?) -> Data
Returns bookmark data for the URL, created with specified options and resource values. URLに対するブックマークデータを返します、指定されたオプションとリソース値で作成されます。
static func bookmarkData(withContentsOf: URL) -> Data
Initializes and returns bookmark data derived from an alias file pointed to by a specified URL. 指定されたURLによって指し示されるエイリアスファイルから引き出されるブックマークデータを初期化して返します。
static func writeBookmarkData(Data, to: URL)
Creates an alias file on disk at a specified location with specified bookmark data. エイリアスファイルをディスク上である指定された位置で作成します、指定されたブックマークデータを使います。
static func resourceValues(forKeys: Set<URLResourceKey>, fromBookmarkData: Data) -> URLResourceValues?
Returns the resource values for properties identified by a specified array of keys contained in specified bookmark data. 指定されたブックマークデータの中に含まれるキーそれらからなるある指定された配列によって識別されるプロパティそれらに対するリソース値を返します。
typealias URL.BookmarkCreationOptions
An alias for bookmark creation options. ブックマーク作成オプションそれらに対するあるエイリアス。
struct NSURL.BookmarkCreationOptions
Options used when creating bookmark data. ブックマークデータを作成している時に使われるオプション。

Checking Reachability 到達可能性を調べる

func checkResourceIsReachable() -> Bool
Returns whether the URL’s resource exists and is reachable. URLのもつリソースが存在して到達可能であるかどうかを返します。

Loading URL Contents Asynchronously

var resourceBytes: URL.AsyncBytes
The URL’s resource data, as an asynchronous sequence of bytes.
var lines: AsyncLineSequence<URL.AsyncBytes>
The URL’s resource data, as an asynchronous sequence of lines of text.
struct URL.AsyncBytes
An asynchronous sequence of bytes loaded from the URL.

Working with Promised Items プロミス項目を扱う

func checkPromisedItemIsReachable() -> Bool
Returns whether the promised item URL’s resource exists and is reachable. プロミス項目URLのもつリソースが存在して到達可能であるかどうかを返します。
func promisedItemResourceValues(forKeys: Set<URLResourceKey>) -> URLResourceValues
Gets resource values from URLs of ‘promised’ items. URLのもつ ‘プロミス’ 項目からリソース値を取得します。

Working with Security Scoped Resources 保安作用域リソースを扱う

func startAccessingSecurityScopedResource() -> Bool
Given a url created by resolving a bookmark data created with security scope, make the resource referenced by the url accessible to the process. 保安作用域で作成されたブックマークデータを解決することによって作成されたURLを与えられて、プロセスにアクセス可能なURLによって参照されたリソースを作ります。
func stopAccessingSecurityScopedResource()
Revokes the access granted to the url by a prior successful call to the complementary start function. 相補的な開始関数に対する以前のうまくいった呼び出しによってurlに授けられたアクセスを廃止します。

Comparing URLs URLを比較する

static func != (URL, URL) -> Bool
Returns a Boolean value indicating whether two values are not equal. ２つの値が等しくないかどうかを指し示すブール値を返します。
static func == (URL, URL) -> Bool
Indicates whether two URLs are the same. ２つのURLが同じかどうかを指し示します。

Describing a URL URLを記述する

var description: String
A textual description of the URL. あるURLのテキスト表現。
var debugDescription: String
A textual description of the URL suitable for debugging. デバッグに適するそのURLのテキスト表現。
var customPlaygroundQuickLook: PlaygroundQuickLook
A playground quicklook for the URL. URLに対するプレイグラウンドクイックルック。
Deprecated 非推奨

Supporting Hashing ハッシュ化をサポートする

var hashValue: Int
The computed hash value for the URL. URLに対する計算ハッシュ値。
func hash(into: inout Hasher)
Hashes the essential components of this URL by feeding them into the given hasher. このURLの必須の構成要素を、それらをこの与えられたハーシャーに供給する事によってハッシュ化します。

Using Reference Types 参照型を使用する

class NSURL
An object representing the location of a resource that bridges to URL; use NSURL when you need reference semantics or other Foundation-specific behavior. リソースの位置を表すオブジェクト、それはURLにブリッジします；NSURLを使ってください、あなたが参照意味論または他のFoundation特有の挙動を必要とする場合は。
typealias URL.ReferenceType
An alias for this value type's equivalent reference type. この値型のもつ同等な参照型に対するエイリアス。

Initializers イニシャライザ

init?(FilePath)
init?(FilePath, isDirectory: Bool)

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

func appendPathComponent(String, conformingTo: UTType)
func appendPathExtension(for: UTType)
func appendingPathComponent(String, conformingTo: UTType) -> URL
func appendingPathExtension(for: UTType) -> URL

Relationships 関係

Conforms To 次に準拠

See Also 参照

URLs URL

struct URLComponents
A structure that parses URLs into and constructs URLs from their constituent parts. URLをそれへと構文解析する、そしてURLをそれらの構成パーツから構築する、ある構造体。
struct URLQueryItem
A single name-value pair from the query portion of a URL. URLのクエリ部分からの単一の名前-値のペア。