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

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

Разработчик

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

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

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

NSXMLDocument

Экземпляр NSXMLDocument представляет XML-документ, как усвоено в логическую древовидную структуру. NSXMLDocument объект может иметь многократные дочерние узлы, но только один элемент, корневой элемент. Любой другой узел должен быть a NSXMLNode объект, представляющий комментарий или инструкцию обработки. При попытке добавить какой-либо другой вид дочернего узла к NSXMLDocument объект, такой как атрибут, пространство имен, другой объект документа или элемент кроме корня, NSXMLDocument повышает исключение. Если Вы добавляете допустимый дочерний узел и что объект уже имеет родителя, NSXMLDocument повышает исключение. NSXMLDocument объект может также иметь глобальные документом атрибуты, такие как версия XML, кодировка символов, сослался на DTD и тип MIME.

Инициализаторы NSXMLDocument класс считал внешний источник XML, ли это быть локальным файлом или удаленным веб-сайтом, проанализируйте его и обработайте его в древовидное представление. Можно также создать NSXMLDocument программно. Существуют методы доступа для получения и установки атрибутов документа, методов для преобразования документов с помощью XSLT, метода для того, чтобы динамично проверить документ и методы для распечатывания содержания NSXMLDocument как XML, XHTML, HTML или простой текст.

Класс NSXMLDocument ориентирован на многопотоковое исполнение, пока любой приведенный пример используется только в одном потоке.

Разделение на подклассы примечаний

Методы для переопределения

Разделять на подклассы NSXMLDocument необходимо переопределить основной инициализатор, initWithData:options:error:, и методы упоминаются ниже. В большинстве случаев Вы должны только вызвать реализацию суперкласса, добавляя любой специфичный для подкласса код прежде или после вызова, по мере необходимости.

По умолчанию NSXMLDocument реализации NSObject isEqual: метод для выполнения глубокого сравнения: два NSXMLDocument объекты не считают равными, если у них нет того же имени, тех же дочерних узлов, тех же атрибутов, и т.д. Сравнение не рассматривает родительский узел (и следовательно расположение узла). Если Вы хотите различный стандарт сравнения, переопределения isEqual:.

Специальные замечания

Из-за архитектуры и модели данных NSXML, когда это анализирует и обрабатывает источник XML, это не может знать о Вашем подклассе, если Вы не переопределяете метод класса replacementClassForClass: возвратить Ваш пользовательский класс вместо NSXML класс. Если Ваш пользовательский класс имеет не прямой NSXML дубликат — например, это - подкласс NSXMLNode это представляет разделы CDATA — тогда можно обойти дерево после того, как оно было создано и вставляет новый узел, где это необходимо.

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Инициализация объекты NSXMLDocument
  • init (contentsOfURL:options:error:) - initWithContentsOfURL:options:error:

    Инициализирует и возвращает объект NSXMLDocument, создаваемый из XML или содержимых HTML ССЫЛАЕМОГО URL источника

    Объявление

    Swift

    convenience init?(contentsOfURL url: NSURL, options mask: Int, error error: NSErrorPointer)

    Objective C

    - (instancetype)initWithContentsOfURL:(NSURL *)url options:(NSUInteger)mask error:(NSError **)error

    Параметры

    url

    NSURL объект, указывающий источник URL.

    mask

    Немного маски для входных опций. Можно указать, что многократные опции укусили-OR'ing их. Посмотрите Константы для списка допустимых входных опций.

    error

    Ошибочный объект, что, по возврату, идентифицирует любые ошибки анализа и предупреждения или проблемы соединения.

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

    Инициализированный NSXMLDocument объект, или nil если инициализация перестала работать из-за ошибок анализа или других причин.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithData:options:error:
    – initWithRootElement:
    – initWithXMLString:options:error:

  • init (data:options:error:) - initWithData:options:error: Определяемый инициализатор

    Инициализирует и возвращается NSXMLDocument объект, создаваемый из NSData объект.

    Объявление

    Swift

    init?(data data: NSData, options mask: Int, error error: NSErrorPointer)

    Objective C

    - (instancetype)initWithData:(NSData *)data options:(NSUInteger)mask error:(NSError **)error

    Параметры

    data

    Объект данных с содержанием XML.

    mask

    Немного маски для входных опций. Можно указать, что многократные опции укусили-OR'ing их. Посмотрите Константы для списка допустимых входных опций.

    error

    Ошибочный объект, что, по возврату, идентифицирует любые ошибки анализа и предупреждения или проблемы соединения.

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

    Инициализированный NSXMLDocument объект, или nil если инициализация перестала работать из-за ошибок анализа или других причин.

    Обсуждение

    Этот метод является определяемым инициализатором для NSXMLDocument класс.

    Если Вы указываете NSXMLDocumentTidyXML как одна из опций, NSXMLDocument выполняет несколько операций по зачистке местности на документе XML (таких как удаление ведущих вкладок). Это действительно уважает xml:space="preserve" припишите, когда это попытается привести в порядок XML.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithContentsOfURL:options:error:
    – initWithRootElement:
    – initWithXMLString:options:error:

  • init (rootElement:) - initWithRootElement: Определяемый инициализатор

    Возвраты NSXMLDocument объект, инициализированный с единственным дочерним элементом, корневым элементом.

    Объявление

    Swift

    init!(rootElement root: NSXMLElement!)

    Objective C

    - (instancetype)initWithRootElement:(NSXMLElement *)root

    Параметры

    root

    NSXMLElement объект, представляющий элемент XML.

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

    Инициализированный NSXMLDocument объект, или nil если инициализация перестала работать по какой-либо причине.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithContentsOfURL:options:error:
    – initWithData:options:error:
    – initWithXMLString:options:error:

  • init (XMLString:options:error:) - initWithXMLString:options:error:

    Инициализирует и возвращается NSXMLDocument объект, создаваемый из строки, содержащей текст разметки XML.

    Объявление

    Swift

    convenience init?(XMLString string: String, options mask: Int, error error: NSErrorPointer)

    Objective C

    - (instancetype)initWithXMLString:(NSString *)string options:(NSUInteger)mask error:(NSError **)error

    Параметры

    string

    Строковый объект, содержащий текст разметки XML.

    mask

    Немного маски для входных опций. Можно указать, что многократные опции укусили-OR'ing их. Посмотрите Константы для списка допустимых входных опций.

    error

    Ошибочный объект, что, по возврату, идентифицирует любые ошибки анализа и предупреждения или проблемы соединения.

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

    Инициализированный NSXMLDocument объект, или nil если инициализация перестала работать из-за ошибок анализа или других причин.

    Обсуждение

    Кодирование документа установлено в UTF-8.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithContentsOfURL:options:error:
    – initWithData:options:error:
    – initWithRootElement:

  • replacementClassForClass (_:) + replacementClassForClass:

    Переопределенный подклассами для заменения пользовательским классом класс NSXML, что использование синтаксического анализатора для создания экземпляров узла.

    Объявление

    Swift

    class func replacementClassForClass(_ class: AnyClass) -> AnyClass!

    Objective C

    + (Class)replacementClassForClass:(Class)class

    Параметры

    class

    A Class объект, идентифицирующий класс NSXML, который должен быть заменен Вашим пользовательским классом.

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

    Класс, которым заменяют.

    Обсуждение

    Например, если у Вас есть пользовательский подкласс NSXMLElement то, что Вы хотите использоваться вместо NSXMLElement, Вы сделали бы следующее переопределение:

    • + (Class)replacementClassForClass:(Class)currentClass {
    • if ( currentClass == [NSXMLElement class] ) {
    • return [MyCustomElementClass class];
    • }
    • }

    Этот метод вызывается, прежде чем документ анализируется. Класс, которым заменяют, должен быть подклассом NSXMLNode, NSXMLDocument, NSXMLElement, NSXMLDTD, или NSXMLDTDNode.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setRootElement:

Управление атрибутами документа
  • characterEncoding - characterEncoding

    Возвращает кодировку символов, используемую для XML.

    Объявление

    Swift

    var characterEncoding: String?

    Objective C

    @property(copy) NSString *characterEncoding

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

    Кодировка символов, используемая для XML, или nil если не указано никакое кодирование.

    Обсуждение

    Обычно кодирование указано в определении XML документа, обрабатывающегося, но это может быть установлено в любое время. Если указанное кодирование не соответствует фактическое кодирование, парсинг документа может перестать работать.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setCharacterEncoding:

  • setCharacterEncoding: - setCharacterEncoding:

    Устанавливает кодировку символов получателя к encoding,

    Объявление

    Swift

    var characterEncoding: String?

    Objective C

    @property(copy) NSString *characterEncoding

    Параметры

    encoding

    Строка, указывающая кодирование; это должно соответствовать имя набора символов IANA. Посмотрите http://www .iana.org/assignments/character-sets для списка допустимых спецификаторов кодирования.

    Обсуждение

    Обычно кодирование указано в определении XML документа, обрабатывающегося, но это может быть установлено в любое время. Если указанное кодирование не соответствует фактическое кодирование, парсинг документа мог бы перестать работать.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – characterEncoding

  • documentContentKind - documentContentKind

    Возвращает вид содержания документа для вывода.

    Объявление

    Swift

    var documentContentKind: NSXMLDocumentContentKind

    Objective C

    @property NSXMLDocumentContentKind documentContentKind

    Обсуждение

    Большинство различий среди вида содержания имеет отношение к обработке тегов содержания меньше такой как <br>. Допустимые константы NSXMLDocumentContentKind NSXMLDocumentXMLKind, NSXMLDocumentXHTMLKind, NSXMLDocumentHTMLKind, и NSXMLDocumentTextKind.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setDocumentContentKind:

  • setDocumentContentKind: - setDocumentContentKind:

    Устанавливает вид выходного содержания для получателя.

    Объявление

    Swift

    var documentContentKind: NSXMLDocumentContentKind

    Objective C

    @property NSXMLDocumentContentKind documentContentKind

    Параметры

    kind

    enum постоянная идентификация своего рода содержания документа. Допустимые константы NSXMLDocumentContentKind NSXMLDocumentXMLKind, NSXMLDocumentXHTMLKind, NSXMLDocumentHTMLKind, и NSXMLDocumentTextKind.

    Обсуждение

    Большинство различий среди вида содержания документа имеет отношение к обработке тегов содержания меньше такой как <br>.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – documentContentKind

  • DTD - DTD

    Возвраты NSXMLDTD объект, представляющий внутренний DTD, связался с получателем.

    Объявление

    Swift

    @NSCopying var DTD: NSXMLDTD?

    Objective C

    @property(copy) NSXMLDTD *DTD

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

    NSXMLDTD объект, представляющий внутренний DTD, связался с получателем или nil если не был связан никакой DTD.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setDTD:

  • setDTD: - setDTD: Доступный в OS X v10.4 через OS X v10.9

    Устанавливает внутренний DTD, который будет связан с получателем.

    Объявление

    Objective C

    - (void)setDTD:(NSXMLDTD *)documentTypeDeclaration

    Параметры

    documentTypeDeclaration

    NSXMLDTD объект, представляющий внутренний DTD, который будет связан с получателем.

    Обсуждение

    Когда получатель выписан, это объявление типа документа появляется в выводе, сразу после определения XML.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.4 через OS X v10.9.

    См. также

    – DTD

  • isStandalone - isStandalone Доступный в OS X v10.4 через OS X v10.9

    Возвраты, представляет ли получатель автономный XML-документ — т.е. один без внешнего DTD.

    Объявление

    Objective C

    - (BOOL)isStandalone

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

    YEStrue если получатель представляет автономный XML-документ, NOfalse если «автономное» объявление не присутствовало в оригинале документа и не было установлено с тех пор.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.4 через OS X v10.9.

    См. также

    – setStandalone:

  • setStandalone: - setStandalone:

    Устанавливает булево значение, указывающее, представляет ли получатель автономный XML-документ.

    Объявление

    Swift

    var standalone: Bool

    Objective C

    @property(getter=isStandalone) BOOL standalone

    Параметры

    standalone

    YEStrue если получатель представляет автономный XML-документ, NOfalse иначе.

    Обсуждение

    Автономному документу не связывали внешний DTD с ним.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – isStandalone

  • MIMEType - MIMEType

    Возвращает тип MIME для получателя.

    Объявление

    Swift

    var MIMEType: String?

    Objective C

    @property(copy) NSString *MIMEType

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

    MIME вводит для получателя (например, «text/xml»).

    Обсуждение

    Типы MIME присваиваются IANA (см. http://www .iana.org/assignments/media-types/index.html).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setMIMEType:

  • setMIMEType: - setMIMEType: Доступный в OS X v10.4 через OS X v10.9

    Устанавливает тип MIME получателя.

    Объявление

    Objective C

    - (void)setMIMEType:(NSString *)MIMEType

    Параметры

    MIMEType

    Строковый объект идентификация типа MIME, например, «text/xml». Типы MIME присваиваются IANA (см. http://www .iana.org/assignments/media-types/index.html).

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.4 через OS X v10.9.

    См. также

    – MIMEType

  • URI - URI

    Возвращает URI, идентифицирующий источник этого документа.

    Объявление

    Objective C

    - (NSString *)URI

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

    URI, идентифицирующий источник этого документа или nil если не был установлен этот атрибут.

    См. также

    – setURI:

  • setURI: - setURI:

    Устанавливает URI, идентифицирующий источник этого документа.

    Объявление

    Objective C

    - (void)setURI:(NSString *)URI

    Параметры

    URI

    Строковый объект представление источника URI, или nil удалить текущий URI.

    Обсуждение

    Когда получатель инициализируется с помощью, этот атрибут автоматически установлен initWithContentsOfURL:options:error:.

    См. также

    – URI

  • версия - версия

    Возвращает версию XML получателя.

    Объявление

    Swift

    var version: String?

    Objective C

    @property(copy) NSString *version

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

    Версия XML получателя или nil если версия не имеет, установлены.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setVersion:

  • setVersion: - setVersion:

    Устанавливает версию XML получателя.

    Объявление

    Swift

    var version: String?

    Objective C

    @property(copy) NSString *version

    Параметры

    version

    Строковый объект идентификация версии XML.

    Обсуждение

    В настоящее время версия должна быть или “1.0 “или «1.1».

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – версия

Управление корневым элементом
  • rootElement () - rootElement

    Возвращает корневой элемент получателя.

    Объявление

    Swift

    func rootElement() -> NSXMLElement?

    Objective C

    - (NSXMLElement *)rootElement

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

    Корневой элемент получателя.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setRootElement:

  • setRootElement (_:) - setRootElement:

    Установите корневой элемент получателя.

    Объявление

    Swift

    func setRootElement(_ root: NSXMLElement!)

    Objective C

    - (void)setRootElement:(NSXMLElement *)root

    Параметры

    root

    NSXMLNode объект, который должен быть корневым элементом.

    Обсуждение

    Как побочный эффект, этот метод удаляет все другие дочерние элементы, включая NSXMLNode объекты, представляющие комментарии и инструкции обработки.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – rootElement

Добавление и удаление дочерних узлов
  • addChild (_:) - addChild:

    Добавляет дочерний узел после последнего из существующих дочерних элементов получателя.

    Объявление

    Swift

    func addChild(_ child: NSXMLNode)

    Objective C

    - (void)addChild:(NSXMLNode *)child

    Параметры

    child

    NSXMLNode объект, который будет добавлен.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – insertChild:atIndex:
    – removeChildAtIndex:
    – setChildren:

  • insertChild (_: atIndex:) - insertChild:atIndex:

    Вставляет объект узла в указанной позиции в массиве получателя дочерних элементов.

    Объявление

    Swift

    func insertChild(_ child: NSXMLNode, atIndex index: Int)

    Objective C

    - (void)insertChild:(NSXMLNode *)child atIndex:(NSUInteger)index

    Параметры

    child

    NSXMLNode объект, который будет вставлен. Добавленный узел должен быть NSXMLNode объект, представляющий комментарий, обрабатывая инструкцию или корневой элемент.

    index

    Целое число, указывающее индекс дочерних элементов, выстраивает для вставки child. Индексы дочерних элементов после нового дочернего элемента постепенно увеличиваются. Если index меньше, чем нуль или больше, чем число дочерних элементов, за пределы, исключение повышено.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – addChild:
    – insertChildren:atIndex:
    – removeChildAtIndex:
    – replaceChildAtIndex:withNode:

  • insertChildren (_: atIndex:) - insertChildren:atIndex:

    Вставляет массив дочерних элементов в указанной позиции в массиве получателя дочерних элементов.

    Объявление

    Swift

    func insertChildren(_ children: [AnyObject], atIndex index: Int)

    Objective C

    - (void)insertChildren:(NSArray *)children atIndex:(NSUInteger)index

    Параметры

    children

    Массив NSXMLNode объекты, представляющие комментарии, обрабатывая инструкции или корневой элемент.

    index

    Целое число, идентифицирующее расположение в дочерних элементах получателя, выстраивает для вставки. Индексы дочерних элементов после нового дочернего элемента увеличены [children count]. Если index меньше, чем нуль или больше, чем число дочерних элементов, за пределы, исключение повышено.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – addChild:
    – removeChildAtIndex:
    – replaceChildAtIndex:withNode:
    – setChildren:

  • removeChildAtIndex (_:) - removeChildAtIndex:

    Удаляет дочерний узел получателя, расположенного в указанной позиции в ее массиве дочерних элементов.

    Объявление

    Swift

    func removeChildAtIndex(_ index: Int)

    Objective C

    - (void)removeChildAtIndex:(NSUInteger)index

    Параметры

    index

    Целое число, идентифицирующее позицию дочернего элемента в массиве получателя. Если index меньше, чем нуль или больше, чем число дочерних элементов минус один, за пределы, исключение повышено.

    Обсуждение

    Последующим дочерним элементам уменьшил их индексы один. Удаленный NSXMLNode объект автовыпущен.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – insertChild:atIndex:
    – replaceChildAtIndex:withNode:

  • replaceChildAtIndex (_: withNode:) - replaceChildAtIndex:withNode:

    Заменяет дочерний узел получателя, расположенного в указанной позиции в ее массиве дочерних элементов с другим узлом.

    Объявление

    Swift

    func replaceChildAtIndex(_ index: Int, withNode node: NSXMLNode)

    Objective C

    - (void)replaceChildAtIndex:(NSUInteger)index withNode:(NSXMLNode *)node

    Параметры

    index

    Целое число, идентифицирующее позицию в массиве получателя дочерних элементов. Если index меньше, чем нуль или больше, чем число дочерних элементов минус один, за пределы, исключение повышено.

    node

    NSXMLNode возразите для замены того в index; это должно представлять комментарий, инструкцию обработки или корневой элемент.

    Обсуждение

    Удаленный NSXMLNode объект автовыпущен.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – insertChild:atIndex:
    – removeChildAtIndex:

  • setChildren (_:) - setChildren:

    Устанавливает дочерние узлы получателя.

    Объявление

    Swift

    func setChildren(_ children: [AnyObject]?)

    Objective C

    - (void)setChildren:(NSArray *)children

    Параметры

    children

    Массив NSXMLNode объекты. Каждый из этих объектов должен представлять комментарии, обрабатывая инструкции или корневой элемент; иначе, исключение повышено. Передача в nil удалить все дочерние элементы.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – addChild:
    – insertChildren:atIndex:

Преобразование документа Используя XSLT
  • objectByApplyingXSLT (_: arguments:error:) - objectByApplyingXSLT:arguments:error:

    Применяет правила образца XSLT и шаблоны (указанный как объект данных) к получателю и возвращается, объект документа, содержащий, преобразовал XML или разметку HTML.

    Объявление

    Swift

    func objectByApplyingXSLT(_ xslt: NSData, arguments arguments: [NSObject : AnyObject]?, error error: NSErrorPointer) -> AnyObject?

    Objective C

    - (id)objectByApplyingXSLT:(NSData *)xslt arguments:(NSDictionary *)arguments error:(NSError **)error

    Параметры

    xslt

    Объект данных, содержащий правила образца XSLT и шаблоны.

    arguments

    Словарь, содержащий NSString пары ключ/значение, передающиеся как параметры периода выполнения процессору XSLT. Передача в nil если у Вас нет параметров для передачи.

    error

    Если ошибка происходит, косвенно возвраты NSError объект, инкапсулирующий сообщения об ошибках или предупреждающие сообщения, сгенерирован обработкой XSLT.

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

    В зависимости от намеченного вывода метод возвращается NSXMLDocument возразите или NSData данные, содержащие, преобразовали XML или разметку HTML. Если сообщение, как предполагается, создает простой текст или RTF, то NSData объект возвращается, иначе объект XML-документа. Возвраты метода nil если не успешно выполнялась обработка XSLT.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – objectByApplyingXSLTAtURL:arguments:error:
    – objectByApplyingXSLTString:arguments:error:

  • objectByApplyingXSLTString (_: arguments:error:) - objectByApplyingXSLTString:arguments:error:

    Применяет правила образца XSLT и шаблоны (указанный как строка) к получателю и возвращается, объект документа, содержащий, преобразовал XML или разметку HTML.

    Объявление

    Swift

    func objectByApplyingXSLTString(_ xslt: String, arguments arguments: [NSObject : AnyObject]?, error error: NSErrorPointer) -> AnyObject?

    Objective C

    - (id)objectByApplyingXSLTString:(NSString *)xslt arguments:(NSDictionary *)arguments error:(NSError **)error

    Параметры

    xslt

    Строковый объект, содержащий правила образца XSLT и шаблоны.

    arguments

    Словарь, содержащий NSString пары ключ/значение, передающиеся как параметры периода выполнения процессору XSLT. Передача в nil если у Вас нет параметров для передачи.

    error

    Если ошибка происходит, косвенно возвраты NSError объект, инкапсулирующий сообщения об ошибках или предупреждающие сообщения, сгенерирован обработкой XSLT.

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

    В зависимости от намеченного вывода метод возвращается NSXMLDocument возразите или NSData данные, содержащие, преобразовали XML или разметку HTML. Если сообщение, как предполагается, создает простой текст или RTF, то NSData объект возвращается, иначе объект XML-документа. Возвраты метода nil если не успешно выполнялась обработка XSLT.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – objectByApplyingXSLT:arguments:error:
    – objectByApplyingXSLTAtURL:arguments:error:

  • objectByApplyingXSLTAtURL (_: arguments:error:) - objectByApplyingXSLTAtURL:arguments:error:

    Применяет правила образца XSLT и обрабатывает по шаблону расположенный в указанном URL к получателю и возвращает объект документа, содержащий преобразованную разметку XML или NSData объект, содержащий простой текст, текст RTF, и т.д.

    Объявление

    Swift

    func objectByApplyingXSLTAtURL(_ xsltURL: NSURL, arguments arguments: [NSObject : AnyObject]?, error error: NSErrorPointer) -> AnyObject?

    Objective C

    - (id)objectByApplyingXSLTAtURL:(NSURL *)xsltURL arguments:(NSDictionary *)arguments error:(NSError **)error

    Параметры

    xsltURL

    NSURL объект, указывающий допустимый URL.

    arguments

    Словарь, содержащий NSString пары ключ/значение, передающиеся как параметры периода выполнения процессору XSLT. Передача в nil если у Вас нет параметров для передачи.

    error

    Если ошибка происходит, косвенно возвраты NSError объект, инкапсулирующий сообщения об ошибках или предупреждающие сообщения, сгенерированные обработкой XSLT или от попытки соединиться с веб-сайтом, идентифицированным URL.

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

    В зависимости от намеченного вывода, возвратов NSXMLDocument возразите или NSData данные, содержащие, преобразовали XML или разметку HTML. Если сообщение, как предполагается, создает простой текст или RTF, то NSData объект возвращается, иначе объект XML-документа. Возвраты метода nil если не успешно выполнялась обработка XSLT.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – objectByApplyingXSLT:arguments:error:
    – objectByApplyingXSLTString:arguments:error:

Запись документа как данные XML
  • XMLData - XMLData

    Возвращает строковое представление XML получателя — т.е. весь документ — инкапсулировавший в объекте данных.

    Объявление

    Swift

    @NSCopying var XMLData: NSData { get }

    Objective C

    @property(readonly, copy) NSData *XMLData

    Обсуждение

    Этот метод вызывает XMLDataWithOptions: с опцией NSXMLNodeOptionsNone. Используемое кодирование основывается на значении, возвращенном из characterEncoding или UTF-8, если никакое допустимое кодирование не возвращается тем методом.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – XMLDataWithOptions:

  • XMLDataWithOptions (_:) - XMLDataWithOptions:

    Возвращает строковое представление XML получателя — т.е. весь документ — инкапсулировавший в объекте данных.

    Объявление

    Swift

    func XMLDataWithOptions(_ options: Int) -> NSData

    Objective C

    - (NSData *)XMLDataWithOptions:(NSUInteger)options

    Параметры

    options

    Одна или более опций (укусил-OR'd если многократный) влиять на вывод документа; посмотрите Константы для допустимых выходных опций.

    Обсуждение

    Используемое кодирование основывается на значении, возвращенном из characterEncoding.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – XMLData

Проверка документа
  • validateAndReturnError (_:) - validateAndReturnError:

    Проверяет документ против управляющей схемы и возвращается, соответствует ли документ схеме.

    Объявление

    Swift

    func validateAndReturnError(_ error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)validateAndReturnError:(NSError **)error

    Параметры

    error

    Если сбои проверки, по возврату содержит NSError объект, описывающий причину или причины отказа.

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

    YEStrue если работа проверки успешно выполнилась, иначе NOfalse.

    Обсуждение

    Константы, указывающие вид ошибок проверки, испускаются базовым синтаксическим анализатором; посмотрите NSXMLParser.h для большинства этих констант. Если схема определяется с помощью DTD, этот метод использует NSXMLDTD объектный набор для получателя для проверки. Если схема основывается на XML-схеме, метод использует URL, указанный как значение xsi:schemaLocation атрибут корневого элемента.

    Можно проверить XML-документ, когда он сначала обрабатывается путем указания NSXMLDocumentValidate опция, когда Вы инициализируете NSXMLDocument объект с initWithContentsOfURL:options:error:, initWithData:options:error:, или initWithXMLString:options:error: методы.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setDTD:

Типы данных

  • NSXMLDocumentContentKind NSXMLDocumentContentKind

    Введите используемый для определения вида содержания документа.

    Объявление

    Swift

    enum NSXMLDocumentContentKind : UInt { case XMLKind case XHTMLKind case HTMLKind case TextKind }

    Objective C

    typedef NSUInteger NSXMLDocumentContentKind;

    Обсуждение

    Для возможных значений посмотрите Типы контента Документа.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Константы
  • Опции ввода и вывода

    Опции ввода и вывода, в частности предназначенные для NSXMLDocument объекты.

    Объявление

    Swift

    var NSXMLDocumentTidyHTML: UInt32 { get } var NSXMLDocumentTidyXML: UInt32 { get } var NSXMLDocumentValidate: UInt32 { get } var NSXMLDocumentXInclude: UInt32 { get } var NSXMLDocumentIncludeContentTypeDeclaration: UInt32 { get }

    Objective C

    NSXMLDocumentTidyHTML = 1 << 9, NSXMLDocumentTidyXML = 1 << 10, NSXMLDocumentValidate = 1 << 13, NSXMLDocumentXInclude = 1 << 16, NSXMLDocumentIncludeContentTypeDeclaration = 1 << 18,

    Константы

    • NSXMLDocumentTidyHTML

      NSXMLDocumentTidyHTML

      Форматы HTML в допустимый XHTML во время обработки документа.

      При уборке, NSXMLDocument добавляет разрыв строки перед близким тегом элемента блочного уровня (<p>, <div>, <h1>, и т.д.); это также делает строковое значение <br> или <hr> разрыв строки. Эти операции делают строковое значение HTML <body> более читаемый. После использования этой опции избегите выводить документ как что-либо кроме вида по умолчанию, NSXMLDocumentXHTMLKind.

      (Ввод)

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

    • NSXMLDocumentTidyXML

      NSXMLDocumentTidyXML

      Изменяет уродливый XML в допустимый XML во время обработки документа.

      Это также устраняет «довольно распечатывающее» форматирование, такое как продвижение символов табуляции. Это действительно уважает xml:space="preserve" атрибут.

      (Ввод)

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

    • NSXMLDocumentValidate

      NSXMLDocumentValidate

      Проверяет этот документ против его DTD (внутренний или внешний) или XML-схема.

      (Ввод)

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

    • NSXMLDocumentXInclude

      NSXMLDocumentXInclude

      Замены все узлы XInclude в документе с именуемыми узлами.

      XInclude позволяет клиентам включать части другого XML-документа в документе.

      (Ввод)

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

    • NSXMLDocumentIncludeContentTypeDeclaration

      NSXMLDocumentIncludeContentTypeDeclaration

      Включает объявление типа контента для HTML или XHTML в выводе документа.

      (Вывод)

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

    Обсуждение

    Поскольку NSXMLDocument подкласс NSXMLNode, можно также использовать соответствующие опции ввода и вывода, описанные в Константах в NSXMLNode ссылка класса. Можно указать входные опции в NSXMLDocument методы initWithContentsOfURL:options:error:, initWithData:options:error:, initWithXMLString:options:error:. XMLDataWithOptions: метод выбирает выходные варианты.

  • Типы контента документа

    Определите типы документов.

    Объявление

    Swift

    enum NSXMLDocumentContentKind : UInt { case XMLKind case XHTMLKind case HTMLKind case TextKind }

    Objective C

    enum { NSXMLDocumentXMLKind = 0, NSXMLDocumentXHTMLKind, NSXMLDocumentHTMLKind, NSXMLDocumentTextKind };

    Константы

    • XMLKind

      NSXMLDocumentXMLKind

      Тип по умолчанию типа контента документа, который является XML.

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

    • XHTMLKind

      NSXMLDocumentXHTMLKind

      Вывод документа является XHTML.

      Это установлено автоматически если NSXMLDocumentTidyHTML опция установлена, и NSXML обнаруживает HTML.

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

    • HTMLKind

      NSXMLDocumentHTMLKind

      Выводы пустые теги в HTML без близкого тега, такой как <br>.

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

    • TextKind

      NSXMLDocumentTextKind

      Выводит строковое значение документа путем извлечения строковых значений из всех текстовых узлов.

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

    Обсуждение

    Вы указываете одну из констант NSXMLDocumentContentKind в setDocumentContentKind: указать вид содержания, требуемого для вывода документа.