NSXMLDTD

Экземпляр NSXMLDTD класс представляет Определение типа документа. Это сохранено как свойство NSXMLDocument экземпляр, к которому получают доступ через NSXMLDocument метод DTD (и установленный через setDTD:).

В модели данных, NSXMLDTD объект концептуально подобен узлам атрибута и пространству имен: это не считается дочерним элементом NSXMLDocument возразите несмотря на то, что это тесно связано с ним. Это в «корне» мелкого дерева, состоящего прежде всего из узлов, представляющих объявления DTD. Приемлемые дочерние узлы являются экземплярами NSXMLDTDNode класс, а также NSXMLNode объекты, представляющие узлы комментария и узлы инструкции обработки.

Вы создаете NSXMLDTD объект одним из трех способов:

Путем обработки XML-документа с его собственным внутренним (встроенным) DTD
Процессом автономный (внешний) DTD
Программно

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

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

NSObject
NSXMLNode
NSXMLDTD

NSObject
NSXMLNode
NSXMLDTD

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

AnyObject
CVarArgType
Сопоставимый
Hashable
NSCopying
NSObjectProtocol
Печатаемый
NSCopying
NSObject

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Инициализация объекта NSXMLDTD


    
    init (contentsOfURL:options:error:)
    - initWithContentsOfURL:options:error:

Инициализирует и возвращается NSXMLDTD объект создается из объявлений DTD в ССЫЛАЕМОМ 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 многократные опции. Текущие допустимые опции `NSXMLNodePreserveWhitespace` и `NSXMLNodePreserveEntities`; эти константы описаны в разделе «Constants» `NSXMLNode` ссылка.
`error`	По возврату этот параметр содержит `NSError` объект, описывающий любые ошибки и предупреждения, имел отношение к парсингу и удаленному соединению.

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

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

Обсуждение

Вы используете этот метод для создания автономного DTD, который можно после того запросить и использовать для проверки. Можно связать DTD, создаваемый через это сообщение с документом путем отправки setDTD: к NSXMLDocument объект.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– initWithData:options:error:
– validateAndReturnError: (NSXMLDocument)


    
    init (data:options:error:)
    - initWithData:options:error:

Определяемый инициализатор

Инициализирует и возвращается NSXMLDTD объект, создаваемый из объявлений DTD, инкапсулировавших в 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`	Объект данных, содержащий объявления DTD.
`mask`	Немного маски, указывающей входные опции; РАЗРЯДНЫЙ OR многократные опции. Текущие допустимые опции `NSXMLNodePreserveWhitespace` и `NSXMLNodePreserveEntities`; эти константы описаны в разделе «Constants» `NSXMLNode` ссылка.
`error`	По возврату этот параметр содержит `NSError` объект, описывающий любые ошибки и предупреждения, имел отношение к парсингу и удаленному соединению.

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

Обсуждение

Этот метод является определяемым инициализатором для NSXMLDTD класс. Вы используете этот метод для создания автономного DTD, который можно после того запросить и использовать для проверки. Можно связать DTD, создаваемый через это сообщение с документом путем отправки setDTD: к NSXMLDocument объект.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– initWithContentsOfURL:options:error:
– validateAndReturnError: (NSXMLDocument)

Управление идентификаторами DTD

setPublicID: - setPublicID:

Устанавливает общедоступный идентификатор получателя.

Объявление

Swift

var publicID: String?

Objective C

@property(copy) NSString *publicID

Параметры

publicID

Строковый объект указание общедоступного идентификатора.

Обсуждение

Этот идентификатор должен быть в каталоге по умолчанию в /etc/xml/catalog или по пути указан переменной окружения XML_CATALOG_FILES. Когда общедоступный ID установлен система, ID должен также быть установлен.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– publicID
– setSystemID:
publicID - publicID

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

Объявление

Swift

var publicID: String?

Objective C

@property(copy) NSString *publicID

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– setPublicID:


    
    setSystemID:
    - setSystemID:

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

Объявление

Swift

var systemID: String?

Objective C

@property(copy) NSString *systemID

Параметры


      systemID

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– systemID

systemID - systemID

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

Объявление

Swift

var systemID: String?

Objective C

@property(copy) NSString *systemID

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– setSystemID:

Управление дочерними узлами

addChild (_:) - addChild:

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

Объявление

Swift

func addChild(_ child: NSXMLNode)

Objective C

- (void)addChild:(NSXMLNode *)child

Параметры

child

Объект узла, чтобы добавить к существующим дочерним элементам.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– insertChild:atIndex:
– insertChildren:atIndex:
– removeChildAtIndex:
– replaceChildAtIndex:withNode:
– setChildren:


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

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

Объявление

Swift

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

Objective C

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

Параметры

`child`	ОБЪЕКТ УЗЛА XML, представляющий дочерний элемент для вставки.
`index`	Целое число, идентифицирующее расположение в списке получателя дочерних элементов для вставки `child`. Индексы последующих дочерних элементов в списке постепенно увеличиваются одним.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

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


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

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

Объявление

Swift

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

Objective C

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

Параметры

`children`	Массив `NSXMLNode` объекты вставить как дочерние элементы получателя.
`index`	Целое число, идентифицирующее расположение в списке текущих дочерних элементов для создания вставку. Индексы последующих дочерних элементов в списке постепенно увеличиваются числом введенных дочерних элементов.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– addChild:
– insertChild:atIndex:
– removeChildAtIndex:
– replaceChildAtIndex:withNode:
– setChildren:


    
    removeChildAtIndex (_:)
    - removeChildAtIndex:

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

Объявление

Swift

func removeChildAtIndex(_ index: Int)

Objective C

- (void)removeChildAtIndex:(NSUInteger)index

Параметры


      index

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

Обсуждение

Удаленный дочерний узел выпущен.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– addChild:
– insertChild:atIndex:
– insertChildren:atIndex:
– replaceChildAtIndex:withNode:
– setChildren:


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

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

Объявление

Swift

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

Objective C

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

Параметры

`index`	Целое число, идентифицирующее позицию узла в списке получателя дочерних узлов.
`node`	`NSXMLNode` возразите для замены объекта в `index`.

Обсуждение

Замененный дочерний узел выпущен.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– addChild:
– insertChild:atIndex:
– insertChildren:atIndex:
– removeChildAtIndex:
– setChildren:


    
    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:
– insertChild:atIndex:
– insertChildren:atIndex:
– removeChildAtIndex:
– replaceChildAtIndex:withNode:

Получение узлов DTD по имени

predefinedEntityDeclarationForName (_:) + predefinedEntityDeclarationForName:

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

Объявление

Swift

class func predefinedEntityDeclarationForName(_ name: String) -> NSXMLDTDNode?

Objective C

+ (NSXMLDTDNode *)predefinedEntityDeclarationForName:(NSString *)name

Параметры

name

Строка, идентифицирующая предопределенное объявление сущности.

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

Автовыпущенный NSXMLDTDNode объект, или nil если там не идет ни в какое сравнение с name.

Обсуждение

Пять предопределенных ссылок на сущность (или символьные ссылки) “<” (меньше знак), “>” (больше - чем знак), “&\” (амперсанд), “«” (кавычка), и “'” (апостроф).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– entityDeclarationForName:
elementDeclarationForName (_:) - elementDeclarationForName:

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

Объявление

Swift

func elementDeclarationForName(_ elementName: String) -> NSXMLDTDNode?

Objective C

- (NSXMLDTDNode *)elementDeclarationForName:(NSString *)elementName

Параметры

elementName

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

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

Автовыпущенный NSXMLDTDNode объект, или nil если там не идет ни в какое сравнение.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    attributeDeclarationForName (_: elementName:)
    - attributeDeclarationForName:elementName:

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

Объявление

Swift

func attributeDeclarationForName(_ attrName: String, elementName elementName: String) -> NSXMLDTDNode?

Objective C

- (NSXMLDTDNode *)attributeDeclarationForName:(NSString *)attrName elementName:(NSString *)elementName

Параметры

`attrName`	Строковый объект идентификация имени атрибута.
`elementName`	Строковый объект идентификация имени элемента.

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

Автовыпущенный NSXMLDTDNode объект, или nil если нет никакого объявления списка атрибутов соответствия.

Обсуждение

Например, в объявлении списка атрибутов:

      <!ATTLIST person idnum CDATA "0000">

«idnum» соответствовал бы attrName и «лицо» соответствовало бы elementName.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

entityDeclarationForName (_:) - entityDeclarationForName:

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

Объявление

Swift

func entityDeclarationForName(_ entityName: String) -> NSXMLDTDNode?

Objective C

- (NSXMLDTDNode *)entityDeclarationForName:(NSString *)entityName

Параметры

entityName

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

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

Автовыпущенный NSXMLDTDNode объект, или nil если там не идет ни в какое сравнение.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
notationDeclarationForName (_:) - notationDeclarationForName:

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

Объявление

Swift

func notationDeclarationForName(_ notationName: String) -> NSXMLDTDNode?

Objective C

- (NSXMLDTDNode *)notationDeclarationForName:(NSString *)notationName

Параметры

notationName

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

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

Автовыпущенный NSXMLDTDNode объект, или nil если там не идет ни в какое сравнение.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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