Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы основы ссылка класса NSURLComponents

Опции
Развертывание Target:

На этой странице
Язык:

NSURLComponents

NSURLComponents класс является классом, разработанным, чтобы проанализировать URLs на основе RFC 3986 и создать URLs из их составных частей. Его поведение отличается тонко от NSURL класс, соответствующий более старому RFCs. Однако можно легко получить NSURL основанный на объектах на содержании URL компоненты возражают или наоборот.

Вы создаете объект компонентов URL одним из трех способов: от NSString объект, содержащий URL, от NSURL объект, или с нуля при помощи инициализатора по умолчанию. Оттуда, можно изменить компоненты частного лица URL’s и субкомпоненты путем изменения различных свойств, или в незакодированной форме или в ЗАКОДИРОВАННОЙ URL форме. При установке незакодированного свойства можно тогда получить закодированный эквивалент путем чтения закодированного значения свойства и наоборот.

Наследование

Соответствует

Оператор импорта

Swift

import Foundation

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.9 и позже.

Создание и конфигурирование
  • componentsWithString: + componentsWithString:

    Возвращает объект компонентов URL путем парсинга URL в строковой форме.

    Объявление

    Objective C

    + (instancetype)componentsWithString:(NSString *)URLString

    Параметры

    URLString

    URL представляет в виде строки для парсинга.

    Возвращаемое значение

    Возвращает новый объект компонентов URL, или nil если не могла бы быть проанализирована строка URL.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.9 и позже.

  • componentsWithURL:resolvingAgainstBaseURL: + componentsWithURL:resolvingAgainstBaseURL:

    Возвращает объект компонентов URL путем парсинга URL от NSURL объект.

    Объявление

    Objective C

    + (instancetype)componentsWithURL:(NSURL *)url resolvingAgainstBaseURL:(BOOL)resolve

    Параметры

    url

    URL для парсинга.

    resolve

    Средства управления, должен ли URL быть разрешен против его базового URL перед парсингом. Если YEStrue, и если url параметр содержит относительный URL, исходный URL разрешен против его базового URL прежде, чем проанализировать путем вызова absoluteURL метод. Иначе, часть строки используется отдельно.

    Возвращаемое значение

    Возвращает новый объект компонентов URL, или nil если не мог бы быть проанализирован URL.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.9 и позже.

  • init () - init

    Инициализирует объект компонентов URL с nil для каждого компонента.

    Объявление

    Swift

    init()

    Objective C

    - (instancetype)init

    Возвращаемое значение

    Возвращает инициализированный объект компонентов URL, или nil если происходит ошибка.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • init (строка:) - initWithString:

    Инициализирует объект компонентов URL путем парсинга URL в строковой форме.

    Объявление

    Swift

    init?(string URLString: String)

    Objective C

    - (instancetype)initWithString:(NSString *)URLString

    Параметры

    URLString

    URL представляет в виде строки для парсинга.

    Возвращаемое значение

    Возвращает инициализированный объект компонентов URL, или nil если не могла бы быть проанализирована строка URL.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • init (URL:resolvingAgainstBaseURL:) - initWithURL:resolvingAgainstBaseURL:

    Инициализирует объект компонентов URL путем парсинга URL от NSURL объект.

    Объявление

    Swift

    init?(URL url: NSURL, resolvingAgainstBaseURL resolve: Bool)

    Objective C

    - (instancetype)initWithURL:(NSURL *)url resolvingAgainstBaseURL:(BOOL)resolve

    Параметры

    url

    URL для парсинга.

    resolve

    Средства управления, должен ли URL быть разрешен против его базового URL перед парсингом. Если YEStrue, и если url параметр содержит относительный URL, исходный URL разрешен против его базового URL прежде, чем проанализировать путем вызова absoluteURL метод. Иначе, часть строки используется отдельно.

    Возвращаемое значение

    Возвращает инициализированный объект компонентов URL, или nil если не мог бы быть проанализирован URL.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

Получение URL
  • строка строка Свойство

    URL произошел из компонентного объекта в строковой форме. (только для чтения)

    Объявление

    Swift

    var string: String? { get }

    Objective C

    @property(readonly, copy) NSString *string

    Обсуждение

    Если компонентный объект имеет компонент полномочий (пользователь, пароль, узел или порт) и компонент контура, то путь должен или начаться "/" или быть пустой строкой. Иначе, это свойство содержит nil.

    Если NSURLComponents не имеет компонента полномочий (пользователь, пароль, узел или порт) и имеет компонент контура, компонент контура не должен запускаться с "//". Если это делает, это свойство содержит nil.

    Это свойство может использоваться только для получения строки URL на основе значений других свойств. Для конфигурирования компонентов, основанных на объектах на существующей строке URL, вызовите любого componentsWithString: или initWithString: метод.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.10 и позже.

  • URL URL Свойство

    Объект URL произошел из компонентного объекта. (только для чтения)

    Объявление

    Swift

    @NSCopying var URL: NSURL? { get }

    Objective C

    @property(readonly, copy) NSURL *URL

    Обсуждение

    Если компонентный объект имеет компонент полномочий (пользователь, пароль, узел или порт) и компонент контура, то путь должен или начаться "/" или быть пустой строкой. Иначе, это свойство содержит nil.

    Если NSURLComponentsне имеет компонента полномочий (пользователь, пароль, узел или порт) и имеет компонент контура, компонент контура не должен запускаться с "//". Если это делает, это свойство содержит nil.

    Это свойство может использоваться только для получения URL на основе значений других свойств. Для конфигурирования компонентов, основанных на объектах на существующем URL, вызовите любого componentsWithURL:resolvingAgainstBaseURL: или initWithURL:resolvingAgainstBaseURL: метод.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • URLRelativeToURL (_:) - URLRelativeToURL:

    Возвращает объект URL, полученный из компонентного объекта.

    Объявление

    Swift

    func URLRelativeToURL(_ baseURL: NSURL?) -> NSURL?

    Objective C

    - (NSURL *)URLRelativeToURL:(NSURL *)baseURL

    Параметры

    baseURL

    Если не -nil, этот URL используется в качестве части базового URL получающегося объекта URL.

    Обсуждение

    Если компонентный объект имеет компонент полномочий (пользователь, пароль, узел или порт) и компонент контура, то путь должен или начаться "/" или быть пустой строкой. Иначе, это свойство содержит nil.

    Если NSURLComponentsне имеет компонента полномочий (пользователь, пароль, узел или порт) и имеет компонент контура, компонент контура не должен запускаться с "//". Если это делает, это свойство содержит nil.

    Для конфигурирования компонентов, основанных на объектах на существующем URL, вызовите любого componentsWithURL:resolvingAgainstBaseURL: или initWithURL:resolvingAgainstBaseURL: метод.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

Свойства в собственном формате
  • фрагмент фрагмент Свойство

    Компонент URL фрагмента (часть после a # символ), или nil если не существующий.

    Объявление

    Swift

    var fragment: String?

    Objective C

    @property(copy) NSString *fragment

    Обсуждение

    Например, в URL http://www.example.com/index.html#jumpLocation, фрагмент jumpLocation.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • узел узел Свойство

    Узел субкомпонент URL, или nil если не существующий.

    Объявление

    Swift

    var host: String?

    Objective C

    @property(copy) NSString *host

    Обсуждение

    Например, в URL http://www.example.com/index.html, узел www.example.com.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • пароль пароль Свойство

    Пароль субкомпонент URL, или nil если не существующий.

    Объявление

    Swift

    var password: String?

    Objective C

    @property(copy) NSString *password

    Обсуждение

    Например, в URL http://username:password@www.example.com/index.html, пароль password.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • путь путь Свойство

    Компонент URL пути, или nil если не существующий.

    Объявление

    Swift

    var path: String?

    Objective C

    @property(copy) NSString *path

    Обсуждение

    Например, в URL http://www.example.com/index.html, путь /index.html.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • порт порт Свойство

    Компонент URL номера порта, или nil если не существующий.

    Объявление

    Swift

    @NSCopying var port: NSNumber?

    Objective C

    @property(copy) NSNumber *port

    Обсуждение

    Например, в URL http://www.example.com:8080/index.php, номер порта 8080.

    При попытке установить порт в отрицательный номер порта, этот класс выдает исключение.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • запрос запрос Свойство

    Компонент URL запроса как строка, или nil если не существующий.

    Объявление

    Swift

    var query: String?

    Objective C

    @property(copy) NSString *query

    Обсуждение

    Например, в URL http://www.example.com/index.php?key1=value1&key2=value2, строка запроса key1=value1&key2=value2.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

    См. также

    queryItems

  • queryItems queryItems Свойство

    Компонент URL запроса как массив пар имя/значение.

    Объявление

    Swift

    var queryItems: [AnyObject]?

    Objective C

    @property(copy) NSArray *queryItems

    Обсуждение

    Когда Вы получаете значение этого свойства, NSURLComponents класс анализирует query представьте в виде строки и возвращает массив NSURLQueryItem объекты, каждый из которых представляет единственную пару ключ/значение в порядке, в котором они появляются в строке исходного запроса. Поскольку имя может появиться несколько раз в строке единого запроса, name свойства элементов запроса, как гарантируют, не будут уникальны. Если query свойство является пустой строкой, queryItems свойство является пустым массивом. Если query свойство nil, queryItems свойство также nil.

    Когда Вы устанавливаете значение этого свойства, NSURLComponents класс присоединяется к каждой паре имя/значение с a = разделитель и соединения массив с a & разделитель, затем устанавливает query свойство к получившей строке. Установка queryItems свойство к пустому массиву устанавливает query свойство к пустой строке и установка queryItems свойство к nil наборы query свойство к nil.

    Например, в URL http://www.example.com/index.php?key1=value1&key2=value2, значение этого свойства является массивом два NSURLQueryItem объекты: тот, свойство имени которого key1 и чье свойство значения value1, и один, свойство имени которого key2 и чье свойство значения value2.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.10 и позже.

  • схема схема Свойство

    Компонент схемы URL, или nil если не существующий.

    Объявление

    Swift

    var scheme: String?

    Objective C

    @property(copy) NSString *scheme

    Обсуждение

    Например, в URL http://www.example.com/index.html, схема http.

    При попытке установить схему в недопустимую строку схемы, этот класс выдает исключение.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • пользователь пользователь Свойство

    Имя пользователя субкомпонент URL, или nil если не существующий.

    Объявление

    Swift

    var user: String?

    Objective C

    @property(copy) NSString *user

    Обсуждение

    Например, в URL http://username:password@www.example.com/index.html, пользователь username.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

Свойства в ФОРМАТЕ КОДИРОВКИ URL
  • percentEncodedFragment percentEncodedFragment Свойство

    Компонент URL фрагмента (часть после a # символ) выраженный как ЗАКОДИРОВАННАЯ URL строка, или nil если не существующий.

    Объявление

    Swift

    var percentEncodedFragment: String?

    Objective C

    @property(copy) NSString *percentEncodedFragment

    Обсуждение

    Например, в URL http://www.example.com/index.html#jumpLocation, фрагмент jumpLocation.

    Если Вы устанавливаете это значение во что-то, что не является допустимой, закодированной процентом строкой, этот класс выдает исключение.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • percentEncodedHost percentEncodedHost Свойство

    Узел субкомпонент URL, выраженный как ЗАКОДИРОВАННАЯ URL строка, или nil если не существующий.

    Объявление

    Swift

    var percentEncodedHost: String?

    Objective C

    @property(copy) NSString *percentEncodedHost

    Обсуждение

    Например, в URL http://www.example.com/index.html, узел www.example.com.

    Если Вы устанавливаете это значение во что-то, что не является допустимой, закодированной процентом строкой, этот класс выдает исключение.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • percentEncodedPassword percentEncodedPassword Свойство

    Пароль субкомпонент URL, выраженный как ЗАКОДИРОВАННАЯ URL строка, или nil если не существующий.

    Объявление

    Swift

    var percentEncodedPassword: String?

    Objective C

    @property(copy) NSString *percentEncodedPassword

    Обсуждение

    Например, в URL http://username:password@www.example.com/index.html, пароль password.

    Если Вы устанавливаете это значение во что-то, что не является допустимой, закодированной процентом строкой, этот класс выдает исключение.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • percentEncodedPath percentEncodedPath Свойство

    Компонент URL пути, выраженный как ЗАКОДИРОВАННАЯ URL строка, или nil если не существующий.

    Объявление

    Swift

    var percentEncodedPath: String?

    Objective C

    @property(copy) NSString *percentEncodedPath

    Обсуждение

    Например, в URL http://www.example.com/index.html, путь /index.html.

    Если Вы устанавливаете это значение во что-то, что не является допустимой, закодированной процентом строкой, этот класс выдает исключение.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • percentEncodedQuery percentEncodedQuery Свойство

    Компонент URL запроса, выраженный как ЗАКОДИРОВАННАЯ URL строка, или nil если не существующий.

    Объявление

    Swift

    var percentEncodedQuery: String?

    Objective C

    @property(copy) NSString *percentEncodedQuery

    Обсуждение

    Например, в URL http://www.example.com/index.php?key1=value1&key2=value2, строка запроса key1=value1&key2=value2.

    Если Вы устанавливаете это значение во что-то, что не является допустимой, закодированной процентом строкой, этот класс выдает исключение.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • percentEncodedUser percentEncodedUser Свойство

    Имя пользователя субкомпонент URL, выраженный как ЗАКОДИРОВАННАЯ URL строка, или nil если не существующий.

    Объявление

    Swift

    var percentEncodedUser: String?

    Objective C

    @property(copy) NSString *percentEncodedUser

    Обсуждение

    Например, в URL http://username:password@www.example.com/index.html, пользователь username.

    Если Вы устанавливаете это значение во что-то, что не является допустимой, закодированной процентом строкой, этот класс выдает исключение.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.9 и позже.