queryItems

var queryItems: [URLQueryItem]? { get set }

Discussion 議論

When you get this property’s value, the NSURLComponents class parses the query string and returns an array of NSURLQueryItem objects, each of which represents a single key-value pair, in the order in which they appear in the original query string. Because a name may appear more than once in a single query string, the name properties of query items are not guaranteed to be unique. If the query property is an empty string, the queryItems property is an empty array. If the query property is nil, the queryItems property is also nil. あなたがこのプロパティの持つ値を取得する時、NSURLComponentsクラスはquery文字列を構文解析して、NSURLQueryItemオブジェクトそれらからなるある配列を返します、そのそれぞれは単一のキー値ペアを表します、それにおいてそれらが元のクエリ文字列において現れた順番で。ある名前が１回以上ひとつの単一のクエリ文字列の中に現れるかもしれないことから、クエリ項目のnameプロパティは特有であることを保証されません。queryプロパティが空ならば、queryItemsプロパティは空の配列です。queryプロパティがnilならば、queryItemsプロパティもまたnilです。

When you set this property’s value, the NSURLComponents class joins each name/value pair with a = delimiter and joins the array with a & delimiter, then sets the query property to the resulting string. Setting the queryItems property to an empty array sets the query property to an empty string, and setting the the queryItems property to nil sets the query property to nil. あなたがこのプロパティの持つ値を設定する時、NSURLComponentsクラスは各々の名前／値ペアを=区切り子で連結してそして配列を&区切り子で連結します、それからqueryプロパティを結果の文字列に設定します。queryItemsプロパティを空の配列に設定することは、queryプロパティを空の文字列に設定します、そしてqueryItemsプロパティをnilに設定することは、queryプロパティをnilに設定します。

To ensure you can compose and decompose URL queries even with empty components, the NSURLComponents class has the following behavior for cases where no name or value is present: 確実にあなたがURLクエリをたとえ空の構成要素でも合成および分解できるようにするために、NSURLComponentsクラスは名前または値が存在しないところの場合に対して以下の挙動を持ちます：

• If a name-value pair has nothing before its equals sign, the name property of the corresponding query item is a zero-length string. ある名前-値の対がそれの等号の前に何も持たないならば、対応するクエリ項目のnameプロパティはゼロ長文字列です。

• If a name-value pair has nothing after its equals sign, the value property of the corresponding query item is a zero-length string. ある名前-値の対がそれの等号の後ろに何も持たないならば、対応するクエリ項目のvalueプロパティはゼロ長文字列です。

• If a name-value pair has no equals sign, the value property of the corresponding query item is nil. ある名前-値の対が等号を持たないならば、対応するクエリ項目のvalueプロパティはnilです。

• If a name-value pair is empty (that is, the query string starts with &, ends with &, or contains &&), the corresponding query item has a zero-length name and nil value. ある名前-値の対が空である（すなわち、query文字列が&で始まる、&で終わる、または&&を含む）ならば、対応するクエリ項目はゼロ長のnameとnilのvalueを持ちます。

For example, in the URL http://www.example.com/index.php?key1=value1&key2=value2, this property’s value is an array of two NSURLQueryItem objects: one whose name property is key1 and whose value property is value1, and one whose name property is key2 and whose value property is value2. 例えば、URL http://www.example.com/index.php?key1=value1&key2=value2において、このプロパティの持つ値は２つのNSURLQueryItemオブジェクトからなるある配列です：それのnameプロパティがkey1そしてそれのvalueプロパティがvalue1であるもの、そしてそれのnameプロパティがkey2そしてそれのvalueプロパティがvalue2であるもの。