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

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

Разработчик

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

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

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

NSXMLNode

Объекты NSXMLNode класс является узлами в абстрактной, логической древовидной структуре, представляющей XML-документ. Объекты узла могут быть различных видов, соответствуя следующим конструкциям разметки в XML-документе: элемент, атрибут, текст, обрабатывая инструкцию, пространство имен и комментарий. Кроме того, объект узла документа (в частности, экземпляр NSXMLDocument) представляет XML-документ полностью. NSXMLNode объекты могут также представлять объявления типа документа, а также объявления в Определениях типа документа (DTDs). Методы фабрики классов NSXMLNode позвольте Вам создать узлы каждого вида. Только документ, элемент и узлы DTD могут иметь дочерние узлы.

Среди семьи NSXML классов — т.е. Фундаментальные классы с префиксом «NSXML» (исключая NSXMLParser) — NSXMLNode класс является базовым классом. Наследование от него является классами NSXMLElement, NSXMLDocument, NSXMLDTD, и NSXMLDTDNode. NSXMLNode указывает интерфейс, характерный для всех объектов узла XML, и определяет общее поведение узла и атрибуты, например уровень иерархии, имя узла и значение, обход дерева и возможность испустить представительный текст разметки XML.

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

Можно разделить на подклассы NSXMLNode если Вы хотите узлы видов, отличающихся от поддерживаемых, можно также создать подкласс с более специализированными атрибутами или поведением, чем NSXMLNode.

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

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

вид

родитель

имя

childAtIndex:

setName:

childCount

objectValue

дочерние элементы

setObjectValue:

отсоединение

stringValue

localName

setStringValue:resolvingEntities:

префикс

индекс

URI

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

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

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

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Создание и инициализация объектов узла
  • init (вид:) - initWithKind:

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

    Объявление

    Swift

    convenience init(kind kind: NSXMLNodeKind)

    Objective C

    - (instancetype)initWithKind:(NSXMLNodeKind)kind

    Параметры

    kind

    enum постоянный из типа Node Kind Constants это указывает тип узла. Посмотрите Константы для списка допустимых констант NSXMLNodeKind.

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

    NSXMLNode объект, инициализированный с видом или nil если не мог бы быть создан объект. Если kind не допустимый постоянный NSXMLNodeKind, метод возвращается NSXMLNode объект вида NSXMLInvalidKind.

    Обсуждение

    Этот метод вызывает initWithKind:options: с options набор параметра к NSXMLNodeOptionsNone.

    Не используйте этот инициализатор для создания экземпляров NSXMLDTDNode для объявлений списка атрибутов. Вместо этого используйте DTDNodeWithXMLString: метод класса этого класса или initWithXMLString: метод NSXMLDTDNode класс.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

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

    Объявление

    Swift

    init(kind kind: NSXMLNodeKind, options options: Int)

    Objective C

    - (instancetype)initWithKind:(NSXMLNodeKind)kind options:(NSUInteger)options

    Параметры

    kind

    enum постоянный из типа Node Kind Constants это указывает тип узла. Посмотрите Константы для списка допустимых констант NSXMLNodeKind.

    options

    Одна или более констант, указывающих опции инициализации; если существуют многократные константы, РАЗРЯДНЫЙ OR их вместе. Эти опции запрашивают операции на представленном XML, связанном с точностью (например, сохраняя объекты), заключая стиль в кавычки, обрабатывая пустых элементов и других вещей. Посмотрите Константы для списка допустимых констант инициализации узла.

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

    NSXMLNode объект, инициализированный с данным видом и опциями, или nil если не мог бы быть создан объект. Если kind не допустимый постоянный NSXMLNodeKind, метод возвращается NSXMLNode объект вида NSXMLInvalidKind.

    Обсуждение

    Не используйте этот инициализатор для создания экземпляров NSXMLDTDNode для объявлений списка атрибутов. Вместо этого используйте DTDNodeWithXMLString: метод класса этого класса или initWithXMLString: метод NSXMLDTDNode класс.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithKind:

  • документ () + документ

    Возвращает пустой узел документа.

    Объявление

    Swift

    class func document() -> AnyObject?

    Objective C

    + (id)document

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

    Пустой узел документа — т.е. NSXMLDocument экземпляр без корневого элемента или информации об определении XML (версия, кодирование, автономный флаг). Возвраты nil если не мог бы быть создан объект.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • documentWithRootElement (_:) + documentWithRootElement:

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

    Объявление

    Swift

    class func documentWithRootElement(_ element: NSXMLElement!) -> AnyObject?

    Objective C

    + (id)documentWithRootElement:(NSXMLElement *)element

    Параметры

    element

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

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

    NSXMLDocument объект инициализируется с корневым элементом element или nil если не мог бы быть создан объект.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • elementWithName (_:) + elementWithName:

    Возвраты NSXMLElement объект с данным идентификатором тега или имя

    Объявление

    Swift

    class func elementWithName(_ name: String) -> AnyObject?

    Objective C

    + (id)elementWithName:(NSString *)name

    Параметры

    name

    Строка, которая является именем (или идентификатор тега) элемента.

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

    NSXMLElement объект или nil если не мог бы быть создан объект.

    Обсуждение

    Эквивалентная разметка XML <name></name>.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • elementWithName (_: children:attributes:) + elementWithName:children:attributes:

    Возвраты NSXMLElement объект с данным тегом (имя), атрибуты и дочерние элементы.

    Объявление

    Swift

    class func elementWithName(_ name: String!, children children: [AnyObject]?, attributes attributes: [AnyObject]?) -> AnyObject?

    Objective C

    + (id)elementWithName:(NSString *)name children:(NSArray *)children attributes:(NSArray *)attributes

    Параметры

    name

    Строка, которая является именем (идентификатор тега) элемента.

    children

    Массив NSXMLElement объекты или NSXMLNode объекты видов NSXMLElementKind, NSXMLProcessingInstructionKind, NSXMLCommentKind, и NSXMLTextKind. Указать nil при отсутствии дочерних элементов для добавления к этому объекту узла.

    attributes

    Массив NSXMLNode объекты вида NSXMLAttributeKind. Указать nil при отсутствии атрибутов для добавления к этому объекту узла.

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

    NSXMLElement объект или nil если не мог бы быть создан объект.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • elementWithName (_: stringValue:) + elementWithName:stringValue:

    Возвраты NSXMLElement объект с единственным дочерним элементом текстового узла, содержащим указанный текст.

    Объявление

    Swift

    class func elementWithName(_ name: String!, stringValue string: String!) -> AnyObject?

    Objective C

    + (id)elementWithName:(NSString *)name stringValue:(NSString *)string

    Параметры

    name

    Строка, которая является именем (идентификатор тега) элемента.

    string

    Строка, которая является содержанием текстового узла получателя.

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

    NSXMLElement объект с единственным дочерним элементом текстового узла — NSXMLNode объект вида NSXMLTextKind— содержа текст, указанный в string. Возвраты nil если не мог бы быть создан объект.

    Обсуждение

    Эквивалентная разметка XML <name>string</name>.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • elementWithName (_: URI:) + elementWithName:URI:

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

    Объявление

    Swift

    class func elementWithName(_ name: String!, URI URI: String!) -> AnyObject?

    Objective C

    + (id)elementWithName:(NSString *)name URI:(NSString *)URI

    Параметры

    name

    Строка, которая является именем (или идентификатор тега) элемента.

    URI

    URI (Универсальный Идентификатор ресурса), который квалифицирует name.

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

    NSXMLElement объект или nil если не может быть создан объект.

    Обсуждение

    Эквивалентная разметка XML <URI:name></URI:name>.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • attributeWithName (_: stringValue:) + attributeWithName:stringValue:

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

    Объявление

    Swift

    class func attributeWithName(_ name: String, stringValue value: String) -> AnyObject?

    Objective C

    + (id)attributeWithName:(NSString *)name stringValue:(NSString *)value

    Параметры

    name

    Строка, которая является именем атрибута.

    value

    Строка, которая является значением атрибута.

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

    NSXMLNode объект вида NSXMLAttributeKind или nil если не мог бы быть создан объект.

    Обсуждение

    Например, в атрибуте “ID = '12345'”, «ID» является названием атрибута и «12345», является значением атрибута.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • attributeWithName (_: URI:stringValue:) + attributeWithName:URI:stringValue:

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

    Объявление

    Swift

    class func attributeWithName(_ name: String!, URI URI: String!, stringValue value: String!) -> AnyObject?

    Objective C

    + (id)attributeWithName:(NSString *)name URI:(NSString *)URI stringValue:(NSString *)value

    Параметры

    name

    Строка, которая является именем атрибута.

    URI

    URI (Универсальный Идентификатор ресурса), который квалифицирует name.

    value

    Строка, которая является значением атрибута.

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

    NSXMLNode объект вида NSXMLAttributeKind или nil если не мог бы быть создан объект.

    Обсуждение

    Например, в атрибуте “bst:id = '12345'”, «лучший» спецификатор имени (полученный из URI), «ID» является названием атрибута, и «12345» значение атрибута.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • textWithStringValue (_:) + textWithStringValue:

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

    Объявление

    Swift

    class func textWithStringValue(_ value: String!) -> AnyObject?

    Objective C

    + (id)textWithStringValue:(NSString *)value

    Параметры

    value

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

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

    NSXMLNode объект вида NSXMLTextKind инициализированный с текстовым value или nil если не мог бы быть создан объект.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • commentWithStringValue (_:) + commentWithStringValue:

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

    Объявление

    Swift

    class func commentWithStringValue(_ stringValue: String!) -> AnyObject?

    Objective C

    + (id)commentWithStringValue:(NSString *)stringValue

    Параметры

    stringValue

    Строка, указывающая текст комментария. Можно указать nil или пустая строка (см. Возвращаемое значение).

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

    NSXMLNode объект, представляющий узел комментария (NSXMLCommentKind) содержа текст stringValue или nil если не мог бы быть создан объект. Если stringValue nil или пустая строка, довольное меньше узел комментария возвращается (<!--->).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • namespaceWithName (_: stringValue:) + namespaceWithName:stringValue:

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

    Объявление

    Swift

    class func namespaceWithName(_ name: String, stringValue value: String) -> AnyObject?

    Objective C

    + (id)namespaceWithName:(NSString *)name stringValue:(NSString *)value

    Параметры

    name

    Строка, которая является именем пространства имен. Укажите пустую строку для name получить пространство имен по умолчанию.

    value

    Строка, идентифицирующая URI, связанный с пространством имен.

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

    NSXMLNode объект вида NSXMLNamespaceKind или nil если не мог бы быть создан объект.

    Обсуждение

    Эквивалентное объявление пространства имен в разметке XML xmlns:name="value".

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

    Приложения, соединенные на OS X v10.6 или позже, выдадут исключение если name параметр nil.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • DTDNodeWithXMLString (_:) + DTDNodeWithXMLString:

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

    Объявление

    Swift

    class func DTDNodeWithXMLString(_ string: String) -> AnyObject?

    Objective C

    + (id)DTDNodeWithXMLString:(NSString *)string

    Параметры

    string

    Строка, которая является объявлением DTD. Получатель анализирует эту строку для определения вида узла DTD для создания.

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

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

    Обсуждение

    Например, если string следующее:

    • <!ENTITY name (#PCDATA)>

    NSXMLNode в состоянии присвоить создаваемый объект узла своего рода NSXMLEntityDeclarationKind путем парсинга «ENTITY».

    Обратите внимание на то, что, если объявление списка атрибутов (<!ATTLIST...> ) имеет многократные атрибуты NSXMLNode только создает NSXMLDTDNode объект для последнего атрибута в объявлении.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • predefinedNamespaceForPrefix (_:) + predefinedNamespaceForPrefix:

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

    Объявление

    Swift

    class func predefinedNamespaceForPrefix(_ name: String) -> NSXMLNode?

    Objective C

    + (NSXMLNode *)predefinedNamespaceForPrefix:(NSString *)name

    Параметры

    name

    Строка, указывающая префикс для предопределенного пространства имен, например «xml», «xs», или «xsi».

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

    NSXMLNode объект вида NSXMLNamespaceKind или nil если не мог бы быть создан объект. Если что-то другое, чем префикс предопределенного пространства имен указано, возвраты метода nil.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + localNameForName:
    + prefixForName:

  • processingInstructionWithName (_: stringValue:) + processingInstructionWithName:stringValue:

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

    Объявление

    Swift

    class func processingInstructionWithName(_ name: String, stringValue value: String) -> AnyObject?

    Objective C

    + (id)processingInstructionWithName:(NSString *)name stringValue:(NSString *)value

    Параметры

    name

    Строка, которая является именем инструкции обработки.

    value

    Строка, которая является значением инструкции обработки.

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

    NSXMLNode объект вида NSXMLProcessingInstructionKind или nil если не мог бы быть создан объект.

    Обсуждение

    Эквивалентная разметка XML <?name value?>.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Управление объектами узла XML
  • индекс - индекс

    Возвращает индекс получателя, идентифицирующего его позицию относительно его одноуровневых узлов.

    Объявление

    Swift

    var index: Int { get }

    Objective C

    @property(readonly) NSUInteger index

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

    Целое число, которое является индексом получателя относительно его одноуровневых узлов.

    Обсуждение

    Первый дочерний узел родителя имеет индекс нуля.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – childAtIndex:

  • вид - вид

    Возвращает вид узла, который получатель как константа типа Node Kind Constants.

    Объявление

    Swift

    var kind: NSXMLNodeKind { get }

    Objective C

    @property(readonly) NSXMLNodeKind kind

    Обсуждение

    NSXMLNode объекты могут представлять документы, элементы, атрибуты, пространства имен, текст, обрабатывая инструкции, комментарии, объявления типа документа и определенные объявления в DTDs. Посмотрите Константы для списка допустимых констант NSXMLNodeKind

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithKind:

  • уровень - уровень

    Возвращает уровень вложенности получателя в древовидной иерархии.

    Объявление

    Swift

    var level: Int { get }

    Objective C

    @property(readonly) NSUInteger level

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

    Целое число, указывающее уровень вложенности.

    Обсуждение

    Корневой элемент документа имеет уровень вложенности одного.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • setName: - setName:

    Определяет имя получателя.

    Объявление

    Swift

    var name: String?

    Objective C

    @property(copy) NSString *name

    Параметры

    name

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – имя

  • имя - имя

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

    Объявление

    Swift

    var name: String?

    Objective C

    @property(copy) NSString *name

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

    Возвращает строку, указывающую имя получателя. Может возвратиться nil если получатель не является допустимым видом узла (см. обсуждение).

    Обсуждение

    Этот метод применим только к NSXMLNode объекты, представляющие элементы, атрибуты, пространства имен, обрабатывая инструкции и узлы объявления DTD. Если получатель не является объектом одного из этих видов, этот метод возвраты nil. Например, в следующей конструкции:

    • <title>Chapter One</title>

    Возвращенное имя для элемента является «заголовком». Если имя связано с пространством имен, полностью определенное имя возвращается. Например, если Вы создаете элемент с локальным именем «foo» и URI “http://bar.com”, и пространство имен “xmlns:baz =‘http://bar.com’” применяется к этому узлу при вызове этого метода на узел, Вы получаете «baz:foo».

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setName:

  • setObjectValue: - setObjectValue:

    Устанавливает содержание получателя к объектному значению.

    Объявление

    Swift

    var objectValue: AnyObject?

    Objective C

    @property(retain) id objectValue

    Параметры

    value

    Объект присвоиться как значение к получателю.

    Обсуждение

    Этот метод может только быть вызван на NSXMLNode объекты, которые могут иметь содержание, в частности элементы, атрибуты, пространства имен, обрабатывая инструкции, текст и узлы объявления DTD. Данным объектом обычно является Основа, эквивалентная одному из атомарных типов в модели данных XQuery: NSNumber (целое число, десятичное число, плавание, дважды, булевская переменная), NSString (строка), NSCalendarDate (дата), NSData (base64Binary и hexBinary), NSURL (URI), и NSArray (NMTOKENS, IDREFS, ENTITIES). Однако можно также установить объектное значение, чтобы быть пользовательским значением и зарегистрировать преобразователь значения (т.е. экземпляр NSValueTransformer) преобразовать объектное значение в строковое представление XML, когда узел просят относительно его строкового значения.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – objectValue
    – setStringValue:resolvingEntities:

  • objectValue - objectValue

    Возвращает объектное значение получателя.

    Объявление

    Swift

    var objectValue: AnyObject?

    Objective C

    @property(retain) id objectValue

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setObjectValue:
    – setStringValue:

  • setStringValue: - setStringValue:

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

    Объявление

    Swift

    var stringValue: String?

    Objective C

    @property(copy) NSString *stringValue

    Параметры

    string

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

    Обсуждение

    Этот метод вызывает setStringValue:resolvingEntities:, передача в параметре NOfalse для второго параметра. Этот метод может только быть вызван на NSXMLNode объекты, которые могут иметь содержание, в частности элементы, атрибуты, пространства имен, обрабатывая инструкции, текст и узлы объявления DTD. Установка строкового значения объекта узла удаляет все существующие дочерние элементы, включая обработку инструкций и комментариев. Установка строкового значения объекта узла элемента создает текстовый узел как единственный дочерний элемент.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setObjectValue:
    – stringValue

  • setStringValue (_: resolvingEntities:) - setStringValue:resolvingEntities:

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

    Объявление

    Swift

    func setStringValue(_ string: String, resolvingEntities resolve: Bool)

    Objective C

    - (void)setStringValue:(NSString *)string resolvingEntities:(BOOL)resolve

    Параметры

    string

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

    resolve

    YEStrue для разрешения символьных ссылок, предопределил объекты и определяемые пользователем объекты, как объявлено в связанном DTD; NOfalse иначе. Пространству имен и узлам инструкции обработки разрешили их объекты даже если resolve NOfalse.

    Обсуждение

    Определяемые пользователем объекты, не объявленные в DTD, остаются в их неразрешенной форме. Этот метод может только быть вызван на NSXMLNode объекты, которые могут иметь содержание, в частности элементы, атрибуты, пространства имен, обрабатывая инструкции, текст и узлы объявления DTD. Установка строкового значения объекта узла удаляет все существующие дочерние элементы, включая обработку инструкций и комментариев. При установке строкового значения элемента - объект узла создает текстовый узел как единственный дочерний элемент.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setObjectValue:
    – setStringValue:
    – stringValue

  • stringValue - stringValue

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

    Объявление

    Swift

    var stringValue: String?

    Objective C

    @property(copy) NSString *stringValue

    Обсуждение

    Если получатель является объектом узла вида элемента, содержание является содержанием любых дочерних элементов текстового узла. Этот метод рекурсивно посещает узлы элементов и связывает их текстовые узлы в порядке документа без прошедших пробелов. Если содержание получателя установлено как объектное значение, этот метод возвращает строковое значение, представляющее объект. Если объектное значение является одним из стандартных, встроенных (NSNumber, NSCalendarDate, и т.д.), строковое значение находится в стандартном формате, как определено спецификацией типов данных схемы XML W3C. Если объектное значение не представлено одним из этих классов (или если преобразователь значения по умолчанию для класса был переопределен), строковое значение сгенерировано NSValueTransformer зарегистрированный для того типа объекта.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – objectValue
    – setStringValue:
    – setStringValue:resolvingEntities:

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

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

    Объявление

    Objective C

    - (void)setURI:(NSString *)URI

    Параметры

    URI

    URI для соединения с получателем. URI (Универсальный Идентификатор ресурса) является схемой, такой как «http» или «ftp», сопровождаемый символом двоеточия, и затем специфичной для схемы частью.

    Обсуждение

    Получатель должен быть NSXMLElement или NSXMLDocument документ или атрибут (т.е.NSXMLNode объект типа NSXMLAttributeKind). Для документов это - URI источника документа.

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

    Objective C

    @import Foundation;

    Доступность

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

  • URI - URI

    Возвращает URI, связанный с получателем.

    Объявление

    Swift

    var URI: String?

    Objective C

    @property(copy) NSString *URI

    Обсуждение

    URI узла получен из его пространства имен или URI документа; для документов URI прибывает или из проанализированного XML или явно установлен. Вы не можете изменить URI для определенного узла другого для, чем узел документа или пространство имен.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    setURI: (NSXMLDocument)

Навигация по дереву узлов
  • rootDocument - rootDocument

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

    Объявление

    Swift

    var rootDocument: NSXMLDocument? { get }

    Objective C

    @property(readonly, retain) NSXMLDocument *rootDocument

    Обсуждение

    Если получатель является автономным узлом (т.е. узлом во главе отдельного ответвления дерева), этот метод возвраты nil.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • родитель - родитель

    Возвращает родительский узел получателя.

    Объявление

    Swift

    @NSCopying var parent: NSXMLNode? { get }

    Objective C

    @property(readonly, copy) NSXMLNode *parent

    Обсуждение

    Узлы документа и автономные узлы (т.е. корень отдельного ответвления дерева) не имеют никакого родителя, и отправляющий это сообщение им возвраты nil. Непосредственное отношение делает не, всегда существует между родителем и его дочерними элементами; несмотря на то, что пространство имен или узел атрибута не могут быть дочерним элементом, это все еще имеет родительский элемент.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – childCount
    – дочерние элементы

  • childAtIndex (_:) - childAtIndex:

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

    Объявление

    Swift

    func childAtIndex(_ index: Int) -> NSXMLNode?

    Objective C

    - (NSXMLNode *)childAtIndex:(NSUInteger)index

    Параметры

    index

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

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

    NSXMLNode возражает или nil f получатель не имеет никаких дочерних элементов.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – childCount

  • childCount - childCount

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

    Объявление

    Swift

    var childCount: Int { get }

    Objective C

    @property(readonly) NSUInteger childCount

    Обсуждение

    Этот получатель должен быть NSXMLNode объект, представляющий документ, элемент или объявление типа документа. По причинам производительности используйте этот метод вместо того, чтобы получить количество от массива, возвращенного children (например, [[thisNode children] count]).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – childAtIndex:
    – дочерние элементы
    – родитель

  • дочерние элементы - дочерние элементы

    Возвращает неизменный массив, содержащий дочерние узлы получателя (как NSXMLNode объекты).

    Объявление

    Swift

    var children: [AnyObject]? { get }

    Objective C

    @property(readonly, copy) NSArray *children

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – childAtIndex:
    – childCount
    – родитель

  • nextNode - nextNode

    Возвращает следующее NSXMLNode объект в порядке документа.

    Объявление

    Swift

    @NSCopying var nextNode: NSXMLNode? { get }

    Objective C

    @property(readonly, copy) NSXMLNode *nextNode

    Обсуждение

    Вы используете этот метод для «хождения» вперед через древовидную структуру, представляющую раздел XML-документа или документа. (Используйте previousNode пересекать дерево в противоположном направлении.) Порядок документа является естественным порядком, что конструкции XML появляются в тексте разметки. Если Вы отправляете это сообщение в последний узел в дереве, nil возвращается. NSXMLNode пространство имен обходов и узлы атрибута, когда это пересекает дерево в порядке документа.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – nextSibling
    – previousSibling

  • nextSibling - nextSibling

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

    Объявление

    Swift

    @NSCopying var nextSibling: NSXMLNode? { get }

    Objective C

    @property(readonly, copy) NSXMLNode *nextSibling

    Обсуждение

    Этот объект будет иметь index значение, которое является еще одним, чем получатель. Если больше нет последующих одноуровневых элементов (т.е. другие дочерние узлы родителя получателя) возвратов метода nil.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – nextNode
    – previousNode
    – previousSibling

  • previousNode - previousNode

    Возвращает предыдущее NSXMLNode объект в порядке документа.

    Объявление

    Swift

    @NSCopying var previousNode: NSXMLNode? { get }

    Objective C

    @property(readonly, copy) NSXMLNode *previousNode

    Обсуждение

    Вы используете этот метод для «хождения» назад через древовидную структуру, представляющую раздел XML-документа или документа. (Используйте nextNode пересекать дерево в противоположном направлении.) Порядок документа является естественным порядком, что конструкции XML появляются в тексте разметки. Если Вы отправляете это сообщение в первый узел в дереве (т.е. корневой элемент), nil возвращается. NSXMLNode пространство имен обходов и узлы атрибута, когда это пересекает дерево в порядке документа.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – nextSibling
    – previousSibling

  • previousSibling - previousSibling

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

    Объявление

    Swift

    @NSCopying var previousSibling: NSXMLNode? { get }

    Objective C

    @property(readonly, copy) NSXMLNode *previousSibling

    Обсуждение

    Этот объект будет иметь index значение, которое является тем меньше, чем получатель. Если больше нет предыдущих одноуровневых элементов (т.е. другие дочерние узлы родителя получателя) возвратов метода nil

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – nextNode
    – nextSibling
    – previousNode

  • отсоединение () - отсоединение

    Отсоединяет получатель от его родительского узла.

    Объявление

    Swift

    func detach()

    Objective C

    - (void)detach

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Испускание содержания узла
  • XMLString - XMLString

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

    Объявление

    Swift

    var XMLString: String { get }

    Objective C

    @property(readonly, copy) NSString *XMLString

    Обсуждение

    Возвращаемая строка включает строковые представления всех дочерних элементов. Этот метод вызывает XMLStringWithOptions: с options параметр NSXMLNodeOptionsNone.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – canonicalXMLStringPreservingComments:
    – описание

  • XMLStringWithOptions (_:) - XMLStringWithOptions:

    Возвращает строковое представление получателя, как это появилось бы в XML-документе, с один или несколько выходные указанные опции.

    Объявление

    Swift

    func XMLStringWithOptions(_ options: Int) -> String

    Objective C

    - (NSString *)XMLStringWithOptions:(NSUInteger)options

    Параметры

    options

    Один или больше enum константы, идентифицирующие выходную опцию; РАЗРЯДНЫЙ OR многократные константы вместе. Посмотрите Константы для списка допустимых констант для указания выходных опций.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • canonicalXMLStringPreservingComments (_:) - canonicalXMLStringPreservingComments:

    Возвращает строковый объект инкапсуляция XML получателя в канонической форме.

    Объявление

    Swift

    func canonicalXMLStringPreservingComments(_ comments: Bool) -> String

    Objective C

    - (NSString *)canonicalXMLStringPreservingComments:(BOOL)comments

    Параметры

    comments

    YEStrue сохранить комментарии, NOfalse иначе.

    Обсуждение

    Обязательно установите входную опцию NSXMLNodePreserveWhitespace для истинной канонической формы. Каноническая форма XML-документа определяется Консорциумом World Wide Web в http://www.w3.org/TR/xml-c14n. Обычно, если два документа с переменными физическими представлениями имеют ту же каноническую форму, то их считают логически эквивалентными в данном контексте приложения. Следующий список суммирует большинство ключевых аспектов канонической формы, как определено рекомендацией W3C:

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

    • Нормализует разрывы строки к «#xA» на вводе перед парсингом.

    • Нормализует значения атрибута способом процессора проверки.

    • Заменяет ссылки символьной и разобранной сущности их символьным содержанием.

    • Замены CDATA разделяют с их символьным содержанием.

    • Удаляет определение XML и объявление типа документа (DTD).

    • Преобразовывает пустые элементы в пар начинать-конечного-тэга.

    • Нормализует пробел за пределами элемента документа и в запуске и конечных тэгах.

    • Сохраняет все пробельные символы в содержании (исключая символы, удаленные во время нормализации перевода строки).

    • Разделители значения атрибута наборов к кавычкам (двойные кавычки).

    • Специальные символы замен в значениях атрибута и символьном содержании с символьными ссылками.

    • Удаляет лишние объявления пространства имен из каждого элемента.

    • Добавляют атрибуты по умолчанию к каждому элементу.

    • Налагает лексикографический порядок на объявления пространства имен и атрибуты каждого элемента.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – XMLString
    – XMLStringWithOptions:

  • описание - описание

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

    Объявление

    Swift

    var description: String { get }

    Objective C

    @property(readonly, copy) NSString *description

    Обсуждение

    Используйте этот метод для отладки, а не для генерации вывода XML. Это могло привести к большей информации, чем XMLString и XMLStringWithOptions:.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – XMLString
    – XMLStringWithOptions:

Выполнение запросов
  • nodesForXPath (_: ошибка:) - nodesForXPath:error:

    Возвращает узлы, следующие из выполнения запроса XPath на получатель.

    Объявление

    Swift

    func nodesForXPath(_ xpath: String, error error: NSErrorPointer) -> [AnyObject]?

    Objective C

    - (NSArray *)nodesForXPath:(NSString *)xpath error:(NSError **)error

    Параметры

    xpath

    Строка, выражающая запрос XPath.

    error

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

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

    Массив NSXMLNode объекты, соответствующие запрос или пустой массив, при отсутствии соответствий.

    Обсуждение

    Получатель действует как элемент контекста для запроса (“”.). Если Вы явно добавили смежные текстовые узлы как дочерние элементы элемента, необходимо вызвать NSXMLElement метод normalizeAdjacentTextNodesPreservingCDATA: (с параметром NOfalse) на элементе прежде, чем применить любые запросы XPath к нему; этот метод объединяет эти текстовые узлы. Та же предосторожность применяется, если Вы обработали документ, сохраняющий разделы CDATA, и эти разделы смежны с текстовыми узлами.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – XPath

  • objectsForXQuery (_: ошибка:) - objectsForXQuery:error:

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

    Объявление

    Swift

    func objectsForXQuery(_ xquery: String, error error: NSErrorPointer) -> [AnyObject]?

    Objective C

    - (NSArray *)objectsForXQuery:(NSString *)xquery error:(NSError **)error

    Параметры

    xquery

    Строка, выражающая запрос XQuery.

    error

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

    Обсуждение

    Получатель действует как элемент контекста для запроса (“”.). Если получатель был изменен после парсинга для имения многократных смежных текстовых узлов, необходимо вызвать NSXMLElement метод normalizeAdjacentTextNodesPreservingCDATA: (с параметром NOfalse) объединить текстовые узлы прежде, чем запросить.This удобный метод вызывает objectsForXQuery:constants:error: с nil для constants словарь.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – XPath

  • objectsForXQuery (_: constants:error:) - objectsForXQuery:constants:error:

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

    Объявление

    Swift

    func objectsForXQuery(_ xquery: String, constants constants: [NSObject : AnyObject]!, error error: NSErrorPointer) -> [AnyObject]?

    Objective C

    - (NSArray *)objectsForXQuery:(NSString *)xquery constants:(NSDictionary *)constants error:(NSError **)error

    Параметры

    xquery

    Строка, выражающая запрос XQuery.

    constants

    Словарь, содержащий внешне, объявил константы, где имя каждой постоянной переменной является ключом.

    error

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

    Обсуждение

    Получатель действует как элемент контекста для запроса (“”.). Если получатель был изменен после парсинга для имения многократных смежных текстовых узлов, необходимо вызвать NSXMLElement метод normalizeAdjacentTextNodesPreservingCDATA: (с параметром NOfalse) объединить текстовые узлы перед запросами.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – XPath

  • XPath - XPath

    Возвращает выражение XPath, идентифицирующее расположение получателя в дереве документов.

    Объявление

    Swift

    var XPath: String! { get }

    Objective C

    @property(readonly, copy) NSString *XPath

    Обсуждение

    Например, этот метод мог бы возвратить строку, такую как «foo/bar [2]/baz». Результат этого метода может использоваться непосредственно в nodesForXPath:error: и objectsForXQuery:constants:error: методы.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Управление пространствами имен
  • localName - localName

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

    Объявление

    Swift

    var localName: String? { get }

    Objective C

    @property(readonly, copy) NSString *localName

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

    Строка, содержащая локальное имя получателя.

    Обсуждение

    Локальное имя является частью имени узла, следующего за квалифицирующим пространство имен двоеточием или полным именем, если нет никакого двоеточия. Например, «глава» является локальным именем на полностью определенное имя «acme:chapter».

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + localNameForName:

  • localNameForName (_:) + localNameForName:

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

    Объявление

    Swift

    class func localNameForName(_ qName: String) -> String!

    Objective C

    + (NSString *)localNameForName:(NSString *)qName

    Параметры

    qName

    Строка, которая является полностью определенным именем.

    Обсуждение

    Например, если полностью определенное имя является «bst:title», этот метод возвращает «заголовок».

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – localName
    + predefinedNamespaceForPrefix:
    + prefixForName:

  • префикс - префикс

    Возвращает префикс имени получателя.

    Объявление

    Swift

    var prefix: String? { get }

    Objective C

    @property(readonly, copy) NSString *prefix

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

    Строка, содержащая префикс получателя. Если имя получателя не квалифицировано пространством имен, этот метод возвращает пустую строку.

    Обсуждение

    Префикс является частью полностью определенного имени пространства имен, предшествующего двоеточию. Например, «высшая точка» является префиксом на полностью определенное имя «acme:chapter».

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + prefixForName:

  • prefixForName (_:) + prefixForName:

    Возвращает префикс из указанного полностью определенного имени.

    Объявление

    Swift

    class func prefixForName(_ qName: String) -> String?

    Objective C

    + (NSString *)prefixForName:(NSString *)qName

    Параметры

    qName

    Строка, которая является полностью определенным именем.

    Обсуждение

    Например, если полностью определенное имя является «bst:title», этот метод «лучшие» возвраты.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + localNameForName:
    – префикс
    + predefinedNamespaceForPrefix:

Константы
  • Константы вида узла

    NSXMLNode объявляет следующие константы типа NSXMLNodeKind для указания вида узла в методах инициализатора initWithKind: и initWithKind:options::

    Объявление

    Swift

    enum NSXMLNodeKind : UInt { case NSXMLInvalidKind case NSXMLDocumentKind case NSXMLElementKind case NSXMLAttributeKind case NSXMLNamespaceKind case NSXMLProcessingInstructionKind case NSXMLCommentKind case NSXMLTextKind case NSXMLDTDKind case NSXMLEntityDeclarationKind case NSXMLAttributeDeclarationKind case NSXMLElementDeclarationKind case NSXMLNotationDeclarationKind }

    Objective C

    enum { NSXMLInvalidKind = 0, NSXMLDocumentKind, NSXMLElementKind, NSXMLAttributeKind, NSXMLNamespaceKind, NSXMLProcessingInstructionKind, NSXMLCommentKind, NSXMLTextKind, NSXMLDTDKind, NSXMLEntityDeclarationKind, NSXMLAttributeDeclarationKind, NSXMLElementDeclarationKind, NSXMLNotationDeclarationKind }; typedef NSUInteger NSXMLNodeKind;

    Константы

    • NSXMLInvalidKind

      NSXMLInvalidKind

      Указывает объект узла, создаваемый без допустимого указываемого вида (как возвращено kind метод).

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

    • NSXMLDocumentKind

      NSXMLDocumentKind

      Указывает узел документа.

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

    • NSXMLElementKind

      NSXMLElementKind

      Указывает узел элемента.

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

    • NSXMLAttributeKind

      NSXMLAttributeKind

      Указывает узел атрибута

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

    • NSXMLNamespaceKind

      NSXMLNamespaceKind

      Указывает узел пространства имен.

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

    • NSXMLProcessingInstructionKind

      NSXMLProcessingInstructionKind

      Указывает узел инструкции обработки.

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

    • NSXMLCommentKind

      NSXMLCommentKind

      Указывает узел комментария.

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

    • NSXMLTextKind

      NSXMLTextKind

      Указывает текстовый узел.

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

    • NSXMLDTDKind

      NSXMLDTDKind

      Указывает узел объявления типа документа (DTD).

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

    • NSXMLEntityDeclarationKind

      NSXMLEntityDeclarationKind

      Указывает узел объявления сущности.

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

    • NSXMLAttributeDeclarationKind

      NSXMLAttributeDeclarationKind

      Указывает узел объявления списка атрибутов.

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

    • NSXMLElementDeclarationKind

      NSXMLElementDeclarationKind

      Указывает узел объявления элемента.

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

    • NSXMLNotationDeclarationKind

      NSXMLNotationDeclarationKind

      Указывает узел объявления нотации.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Опции ввода и вывода

    Эти константы являются опциями ввода и вывода для всех NSXMLNode объекты (если иначе не обозначено), включая NSXMLDocument объекты. Можно указать эти опции (OR’ing многократные опции) в NSXMLNode методы initWithKind:options: и XMLStringWithOptions:.

    Объявление

    Swift

    var NSXMLNodeOptionsNone: UInt32 { get } var NSXMLNodeIsCDATA: UInt32 { get } var NSXMLNodeExpandEmptyElement: UInt32 { get } var NSXMLNodeCompactEmptyElement: UInt32 { get } var NSXMLNodeUseSingleQuotes: UInt32 { get } var NSXMLNodeUseDoubleQuotes: UInt32 { get } var NSXMLNodeLoadExternalEntitiesAlways: UInt32 { get } var NSXMLNodeLoadExternalEntitiesSameOriginOnly: UInt32 { get } var NSXMLNodeLoadExternalEntitiesNever: UInt32 { get } var NSXMLNodePrettyPrint: UInt32 { get } var NSXMLNodePreserveNamespaceOrder: UInt32 { get } var NSXMLNodePreserveAttributeOrder: UInt32 { get } var NSXMLNodePreserveEntities: UInt32 { get } var NSXMLNodePreserveCharacterReferences: UInt32 { get } var NSXMLNodePreservePrefixes: UInt32 { get } var NSXMLNodePreserveCDATA: UInt32 { get } var NSXMLNodePreserveWhitespace: UInt32 { get } var NSXMLNodePreserveEmptyElements: UInt32 { get } var NSXMLNodePreserveQuotes: UInt32 { get } var NSXMLNodePreserveDTD: UInt32 { get } var NSXMLNodePreserveAll: UInt32 { get }

    Objective C

    enum { NSXMLNodeOptionsNone = 0, NSXMLNodeIsCDATA = 1 << 0, NSXMLNodeExpandEmptyElement = 1 << 1, // <a></a> NSXMLNodeCompactEmptyElement = 1 << 2, // <a/> NSXMLNodeUseSingleQuotes = 1 << 3, NSXMLNodeUseDoubleQuotes = 1 << 4, NSXMLDocumentTidyHTML = 1 << 9, NSXMLDocumentTidyXML = 1 << 10, NSXMLDocumentValidate = 1 << 13, NSXMLNodeLoadExternalEntitiesAlways = 1UL << 14, NSXMLNodeLoadExternalEntitiesSameOriginOnly = 1UL << 15, NSXMLNodeLoadExternalEntitiesNever = 1UL << 19, NSXMLDocumentXInclude = 1 << 16, NSXMLNodePrettyPrint = 1 << 17, NSXMLDocumentIncludeContentTypeDeclaration = 1 << 18, NSXMLNodePreserveNamespaceOrder = 1 << 20, NSXMLNodePreserveAttributeOrder = 1 << 21, NSXMLNodePreserveEntities = 1 << 22, NSXMLNodePreservePrefixes = 1 << 23, NSXMLNodePreserveCDATA = 1 << 24, NSXMLNodePreserveWhitespace = 1 << 25, NSXMLNodePreserveDTD = 1 << 26, NSXMLNodePreserveCharacterReferences = 1 << 27, NSXMLNodePreserveEmptyElements = (NSXMLNodeExpandEmptyElement | NSXMLNodeCompactEmptyElement ), NSXMLNodePreserveQuotes = (NSXMLNodeUseSingleQuotes | NSXMLNodeUseDoubleQuotes ), NSXMLNodePreserveAll = ( NSXMLNodePreserveNamespaceOrder | NSXMLNodePreserveAttributeOrder | NSXMLNodePreserveEntities | NSXMLNodePreservePrefixes | NSXMLNodePreserveCDATA | NSXMLNodePreserveEmptyElements | NSXMLNodePreserveQuotes | NSXMLNodePreserveWhitespace | NSXMLNodePreserveDTD | NSXMLNodePreserveCharacterReferences | 0xFFF00000 ) // high 12 bits };

    Константы

    • NSXMLNodeOptionsNone

      NSXMLNodeOptionsNone

      Никакие опции не требуют на это действие ввода или вывода.

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

    • NSXMLNodeIsCDATA

      NSXMLNodeIsCDATA

      Указывает, что текстовый узел содержит и выписан как раздел CDATA.

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

    • NSXMLNodeExpandEmptyElement

      NSXMLNodeExpandEmptyElement

      Запросы, что элемент должен быть расширен когда пустой; например, <flag></flag>. Это - значение по умолчанию.

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

    • NSXMLNodeCompactEmptyElement

      NSXMLNodeCompactEmptyElement

      Запросы, что элемент должен быть заключен когда пустой; например, <flag/>.

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

    • NSXMLNodeUseSingleQuotes

      NSXMLNodeUseSingleQuotes

      Запросы, что NSXML используют одинарные кавычки для значения узла пространства имен или атрибута.

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

    • NSXMLNodeUseDoubleQuotes

      NSXMLNodeUseDoubleQuotes

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

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

    • NSXMLNodeLoadExternalEntitiesAlways

      NSXMLNodeLoadExternalEntitiesAlways

      Запросы, что всегда загружаются внешние объекты.

      Запросы, что всегда загружаются внешние объекты. Можно выбрать только один из NSXMLNodeLoadExternalEntitiesAlways, NSXMLNodeLoadExternalEntitiesSameOriginOnly, или NSXMLNodeLoadExternalEntitiesNever или ни один.

      Выбор ни одного приводит к поведению системного значения по умолчанию. Для приложений, соединенных на OS X v10.6 и ранее, это NSXMLNodeLoadExternalEntitiesAlways. Для приложений, соединенных на OS X v10.7 или позже, загружаются все объекты, не требующие доступа к сети.

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

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

    • NSXMLNodeLoadExternalEntitiesSameOriginOnly

      NSXMLNodeLoadExternalEntitiesSameOriginOnly

      Запросы, что внешние объекты всегда загружаются и только применяются, когда был предоставлен URL.

      Это загружает объекты целевым URLs, соответствующим узел, схему и порт документа, из которого URL.You может выбрать только один из NSXMLNodeLoadExternalEntitiesAlways, NSXMLNodeLoadExternalEntitiesSameOriginOnly, или NSXMLNodeLoadExternalEntitiesNever или ни один.

      Выбор ни одного приводит к поведению системного значения по умолчанию. Для приложений, соединенных на OS X v10.6 и ранее, это NSXMLNodeLoadExternalEntitiesAlways. Для приложений, соединенных на OS X v10.7 или позже, загружаются все объекты, не требующие доступа к сети.

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

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

    • NSXMLNodeLoadExternalEntitiesNever

      NSXMLNodeLoadExternalEntitiesNever

      Запросы, что никогда не загружаются внешние объекты.

      Можно выбрать только один из NSXMLNodeLoadExternalEntitiesAlways, NSXMLNodeLoadExternalEntitiesSameOriginOnly, или NSXMLNodeLoadExternalEntitiesNever или ни один.

      Запросы, что никогда не загружаются внешние объекты. Можно выбрать только один из NSXMLNodeLoadExternalEntitiesAlways, NSXMLNodeLoadExternalEntitiesSameOriginOnly, или NSXMLNodeLoadExternalEntitiesNever или ни один.

      Выбор ни одного приводит к поведению системного значения по умолчанию. Для приложений, соединенных на OS X v10.6 и ранее, это NSXMLNodeLoadExternalEntitiesAlways. Для приложений, соединенных на OS X v10.7 или позже, загружаются все объекты, не требующие доступа к сети.

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

    • NSXMLNodePrettyPrint

      NSXMLNodePrettyPrint

      Распечатайте этот узел с дополнительным пространством для удобочитаемости. (Вывод)

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

    • NSXMLNodePreserveNamespaceOrder

      NSXMLNodePreserveNamespaceOrder

      Запросы NSXML для сохранения порядка пространства имен определения URI как в источнике XML.

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

    • NSXMLNodePreserveAttributeOrder

      NSXMLNodePreserveAttributeOrder

      Запросы, что NSXMLNode сохраняют порядок атрибутов как в источнике XML.

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

    • NSXMLNodePreserveEntities

      NSXMLNodePreserveEntities

      Указывает это объекты (&xyz;) не должен быть разрешен для вывода XML этого узла.

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

    • NSXMLNodePreserveCharacterReferences

      NSXMLNodePreserveCharacterReferences

      Указывает тот символьные ссылки (&#nnn;) не должен быть разрешен для вывода XML этого узла.

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

    • NSXMLNodePreservePrefixes

      NSXMLNodePreservePrefixes

      Запросы NSXMLNode для не выбора префиксов на основе самого близкого пространства имен определение URI.

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

    • NSXMLNodePreserveCDATA

      NSXMLNodePreserveCDATA

      Запросы, что NSXMLNode сохраняют блоки CDATA, где определено во вводе XML.

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

    • NSXMLNodePreserveWhitespace

      NSXMLNodePreserveWhitespace

      NSXMLNode запросов для сохранения пробельных символов (таких как вкладки и возвраты каретки) в исходном коде XML, которые не являются частью содержания узла.

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

    • NSXMLNodePreserveEmptyElements

      NSXMLNodePreserveEmptyElements

      Указывает что пустые элементы во вводе XML быть сохраненным в их договорной или расширенной форме.

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

    • NSXMLNodePreserveQuotes

      NSXMLNodePreserveQuotes

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

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

    • NSXMLNodePreserveDTD

      NSXMLNodePreserveDTD

      Указывает, что объявления в DTD должны быть сохранены до него, DTD изменяется. Например, сущность параметра по умолчанию расширена; с этой опцией они выписаны, поскольку они первоначально происходят в DTD.

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

    • NSXMLNodePreserveAll

      NSXMLNodePreserveAll

      Включает все опции сохранения: атрибут и порядок пространства имен, объекты, префиксы, CDATA, пробел, кавычки и пустые элементы. Необходимо попытаться включить опции сохранения выборочно, потому что включение всех опций сохранения значительно влияет на производительность.

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

    Обсуждение

    Опции с «Заповедником» на их имена применимы только, когда анализируются внешние источники XML; они не имеют никакого эффекта на программно создающиеся объекты узла. Другие опции используются в инициализации и выходных методах NSXMLDocument; посмотрите NSXMLDocument справочная документация для подробных данных.