Class

NSURLComponents

An object that parses URLs into and constructs URLs from their constituent parts. URLをそれへと構文解析する、そしてURLをそれらの構成パーツから構築する、あるオブジェクト。

Declaration 宣言 

@interface NSURLComponents : NSObject

Overview 概要

The NSURLComponents class is a class that is designed to parse URLs based on RFC 3986 and to construct URLs from their constituent parts. Its behavior differs subtly from the NSURL class, which conforms to older RFCs. However, you can easily obtain an NSURL object based on the contents of a URL components object or vice versa. NSURLComponentsクラスは、URLをRFC 3986に基づいて構成要素に分析するためにそしてURLをそれらの構成要素から組み立てるために設計されるクラスです。それの挙動は、NSURLクラスとは微妙に異なります、それはより古いRFCに準拠します。しかしながら、あなたは簡単にNSURLオブジェクトを入手することがURL構成要素オブジェクトに基づき可能です、また逆も同じ。

You create a URL components object in one of three ways: from an NSString object that contains a URL, from an NSURL object, or from scratch by using the default initializer. From there, you can modify the URL’s individual components and subcomponents by modifying various properties, either in unencoded form or in URL-encoded form. If you set the unencoded property, you can then obtain the encoded equivalent by reading the encoded property value and vice versa. あなたは、URL構成要素オブジェクトを３つの方法の１つで作成します：URLを含むNSStringオブジェクトから、NSURLオブジェクトから、または省略時のイニシャライザを使うことによってゼロから。そこから、あなたはURLの持つ個々の構成要素および下位構成要素を修正することが、様々なプロパティの修正によって可能です、非符号化形式においてまたはURL符号化形式においてのどちらかで。あなたが非符号化プロパティを設定するならば、あなたはそのとき符号化された同等物を入手することが、符号化されたプロパティ値を読み出すことによって可能です、また逆も同じ。

Topics 話題

Creating URL Components URL構成要素を作成する

+ componentsWithString:
Returns a URL components object by parsing a URL in string form. URL構成要素オブジェクトをあるURLを文字列形式で構文解析することによって初期化します。
+ componentsWithURL:resolvingAgainstBaseURL:
Returns a URL components object by parsing the URL from an NSURL object. あるURL構成要素オブジェクトをあるURLをNSURLオブジェクトから構文解析することによって返します。
- init
Initializes a URL components object with nil for every component. あるURL構成要素オブジェクトをあらゆる構成要素に対してnilを使って初期化します。
- initWithString:
Initializes a URL components object by parsing a URL in string form. あるURL構成要素オブジェクトをあるURLを文字列形式で構文解析することによって初期化します。
- initWithURL:resolvingAgainstBaseURL:
Initializes a URL components object by parsing the URL from an NSURL object. あるURL構成要素オブジェクトをNSURLオブジェクトからURLを構文解析することによって初期化します。

Getting the URL URLを取得する

string
A URL derived from the components object, in string form. 構成要素オブジェクトから引き出されるURL、文字列形式で。
URL
A URL object derived from the components object. 構成要素オブジェクトから引き出されるURLオブジェクト。
- URLRelativeToURL:
Returns a URL object derived from the components object. 構成要素オブジェクトから引き出されるURLオブジェクトを返します。

Accessing Components in Native Format 構成要素にネイティブ形式でアクセスする

fragment
The fragment URL component (the part after a # symbol), or nil if not present. 断片URL構成要素（#表象の後の部分）、または存在しないならばnil。
host
The host URL subcomponent, or nil if not present. ホストURL下位構成要素、または存在しないならばnil。
password
The password URL subcomponent, or nil if not present. パスワードURL下位構成要素、または存在しないならばnil。
path
The path URL component, or nil if not present. パスURL構成要素、または存在しないならばnil。
port
The port number URL component, or nil if not present. ポート番号URL構成要素、または存在しないならばnil。
query
The query URL component as a string, or nil if not present. クエリURL構成要素、ある文字列として、または存在しないならばnil。
queryItems
The query URL component as an array of name/value pairs. クエリURL構成要素、名前／値のペアからなるある配列として。
scheme
The scheme URL component, or nil if not present. スキームURL構成要素、または存在しないならばnil。
user
The username URL subcomponent, or nil if not present. ユーザ名URL下位構成要素、または存在しないならばnil。

Accessing Components in URL-Encoded Format 構成要素にURL符号化形式でアクセスする

percentEncodedFragment
The fragment URL component (the part after a # symbol) expressed as a URL-encoded string, or nil if not present. 断片URL構成要素（#表象の後の部分）、URL符号化文字列として表現される、または存在しないならばnil。
percentEncodedHost
The host URL subcomponent expressed as a URL-encoded string, or nil if not present. ホストURL下位構成要素、URL符号化文字列として表現される、または存在しないならばnil。
percentEncodedPassword
The password URL subcomponent expressed as a URL-encoded string, or nil if not present. パスワードURL下位構成要素、URL符号化文字列として表現される、または存在しないならばnil。
percentEncodedPath
The path URL component expressed as a URL-encoded string, or nil if not present. ホストURL構成要素、URL符号化文字列として表現される、または存在しないならばnil。
percentEncodedQuery
The query URL component expressed as a URL-encoded string, or nil if not present. クエリURL構成要素、URL符号化文字列として表現される、または存在しないならばnil。
percentEncodedUser
The username URL subcomponent expressed as a URL-encoded string, or nil if not present. ユーザ名URL下位構成要素、URL符号化文字列として表現される、または存在しないならばnil。

Locating Components in the URL String Representation 構成要素をURL文字列表現において位置決めする

percentEncodedQueryItems
rangeOfFragment
Returns the character range of the fragment in the string returned by the string property. 文字列プロパティによって返される文字列におけるフラグメントの文字範囲を返します。
rangeOfHost
Returns the character range of the host in the string returned by the string property. 文字列プロパティによって返される文字列におけるホストの文字範囲を返します。
rangeOfPassword
Returns the character range of the password in the string returned by the string property. 文字列プロパティによって返される文字列におけるパスワードの文字範囲を返します。
rangeOfPath
Returns the character range of the path in the string returned by the string property. 文字列プロパティによって返される文字列におけるパスの文字範囲を返します。
rangeOfPort
Returns the character range of the port in the string returned by the string property. 文字列プロパティによって返される文字列におけるポートの文字範囲を返します。
rangeOfQuery
Returns the character range of the query in the string returned by the string property. 文字列プロパティによって返される文字列におけるクエリの文字範囲を返します。
rangeOfScheme
Returns the character range of the scheme in the string returned by the string property. 文字列プロパティによって返される文字列におけるスキームの文字範囲を返します。
rangeOfUser
Returns the character range of the user in the string returned by the string property. 文字列プロパティによって返される文字列におけるユーザの文字範囲を返します。

Relationships 関係

Inherits From 継承元

Conforms To 次に準拠

See Also 参照

URLs URL

NSURL
An object that represents the location of a resource, such as an item on a remote server or the path to a local file. あるオブジェクト、それはあるリソースの場所を表します、例えばリモートサーバー上のある項目またはあるローカルファイルへのパスなど。
NSURLQueryItem
An object representing a single name/value pair for an item in the query portion of a URL. URLのクエリ部分の中のある項目に対する単一の名前／値のペアを表しているあるオブジェクト。