NSXMLParserDelegate

NSXMLParserDelegate протокол определяет дополнительные методы, реализованные делегатами NSXMLParser объекты.

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

Не применимый

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

NSObjectProtocol
NSObject

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Обработка XML

parserDidStartDocument (_:) - parserDidStartDocument:

Отправленный синтаксическим анализатором возражают против делегата, когда он начинает анализировать документ.

Объявление

Swift

optional func parserDidStartDocument(_ parser: NSXMLParser!)

Objective C

- (void)parserDidStartDocument:(NSXMLParser *)parser

Параметры

parser

Объект синтаксического анализатора.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.3 и позже.
Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parserDidEndDocument:
parserDidEndDocument (_:) - parserDidEndDocument:

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

Объявление

Swift

optional func parserDidEndDocument(_ parser: NSXMLParser!)

Objective C

- (void)parserDidEndDocument:(NSXMLParser *)parser

Параметры

parser

Объект синтаксического анализатора.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.3 и позже.
Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parserDidStartDocument:


    
    синтаксический анализатор (_: didStartElement:namespaceURI:qualifiedName:attributes:)
    - parser:didStartElement:namespaceURI:qualifiedName:attributes:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, didStartElement elementName: String!, namespaceURI namespaceURI: String!, qualifiedName qualifiedName: String!, attributes attributeDict: [NSObject : AnyObject]!)

Objective C

- (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qualifiedName attributes:(NSDictionary *)attributeDict

Параметры

`parser`	Объект синтаксического анализатора.
`elementName`	Строка, которая является именем элемента (в его теге запуска).
`namespaceURI`	Если обработка пространства имен включена, содержит URI для текущего пространства имен как строковый объект.
`qualifiedName`	Если обработка пространства имен включена, содержит полностью определенное имя для текущего пространства имен как строковый объект.
`attributeDict`	Словарь, содержащий любые атрибуты, связанные с элементом. Ключи являются именами атрибутов, и значения являются значениями атрибута.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:didEndElement:namespaceURI:qualifiedName:
setShouldProcessNamespaces: (NSXMLParser)


    
    синтаксический анализатор (_: didEndElement:namespaceURI:qualifiedName:)
    - parser:didEndElement:namespaceURI:qualifiedName:

Отправленный синтаксическим анализатором возражают против его делегата, когда он встречается с конечным тэгом для определенного элемента.

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, didEndElement elementName: String!, namespaceURI namespaceURI: String!, qualifiedName qName: String!)

Objective C

- (void)parser:(NSXMLParser *)parser didEndElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName

Параметры

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:didStartElement:namespaceURI:qualifiedName:attributes:
setShouldProcessNamespaces: (NSXMLParser)


    
    синтаксический анализатор (_: didStartMappingPrefix:toURI:)
    - parser:didStartMappingPrefix:toURI:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, didStartMappingPrefix prefix: String!, toURI namespaceURI: String!)

Objective C

- (void)parser:(NSXMLParser *)parser didStartMappingPrefix:(NSString *)prefix toURI:(NSString *)namespaceURI

Параметры

`parser`	Объект синтаксического анализатора.
`prefix`	Строка, которая является префиксом пространства имен.
`namespaceURI`	Строка, указывающая пространство имен URI.

Обсуждение

Объект синтаксического анализатора отправляет это сообщение только, когда префиксное пространством имен создание отчетов включено через setShouldReportNamespacePrefixes: метод.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:didEndMappingPrefix:


    
    синтаксический анализатор (_: didEndMappingPrefix:)
    - parser:didEndMappingPrefix:

Когда данный префикс пространства имен выходит из объема, отправленный синтаксическим анализатором возражают против его делегата.

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, didEndMappingPrefix prefix: String!)

Objective C

- (void)parser:(NSXMLParser *)parser didEndMappingPrefix:(NSString *)prefix

Параметры

`parser`	Объект синтаксического анализатора.
`prefix`	Строка, которая является префиксом пространства имен.

Обсуждение

Синтаксический анализатор отправляет это сообщение только, когда префиксное пространством имен создание отчетов включено через setShouldReportNamespacePrefixes: метод.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:didStartMappingPrefix:toURI:


    
    синтаксический анализатор (_: resolveExternalEntityName:systemID:)
    - parser:resolveExternalEntityName:systemID:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, resolveExternalEntityName entityName: String!, systemID systemID: String!) -> NSData!

Objective C

- (NSData *)parser:(NSXMLParser *)parser resolveExternalEntityName:(NSString *)entityName systemID:(NSString *)systemID

Параметры

`parser`	Объект синтаксического анализатора.
`entityName`	Строка, указывающая внешнее имя объекта.
`systemID`	Строка, указывающая систему ID для внешнего объекта.

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

NSData объект, содержащий разрешение данного внешнего объекта.

Обсуждение

Делегат может разрешить внешний объект (например, расположившись и читая внешне заявленный DTD) и обеспечить результат для объекта синтаксического анализатора как NSData объект.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:foundExternalEntityDeclarationWithName:publicID:systemID:
– parser:foundUnparsedEntityDeclarationWithName:publicID:systemID:notationName:


    
    синтаксический анализатор (_: parseErrorOccurred:)
    - parser:parseErrorOccurred:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, parseErrorOccurred parseError: NSError!)

Objective C

- (void)parser:(NSXMLParser *)parser parseErrorOccurred:(NSError *)parseError

Параметры

`parser`	Объект синтаксического анализатора.
`parseError`	`NSError` объект, описывающий произошедшую ошибку анализа.

Обсуждение

Когда этот метод вызывается, парсинг останавливается. Для получения дополнительной информации об ошибке, можно запросить parseError или можно отправить parser a parserError сообщение. Можно также отправить синтаксический анализатор lineNumber и columnNumber сообщения для дальнейшей изоляции, где произошла ошибка. Обычно Вы реализуете этот метод для отображения информации об ошибке пользователю.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:validationErrorOccurred:


    
    синтаксический анализатор (_: validationErrorOccurred:)
    - parser:validationErrorOccurred:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, validationErrorOccurred validError: NSError!)

Objective C

- (void)parser:(NSXMLParser *)parser validationErrorOccurred:(NSError *)validError

Параметры

`parser`	Объект синтаксического анализатора.
`validError`	`NSError` объект, описывающий произошедшую ошибку проверки.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:parseErrorOccurred:


    
    синтаксический анализатор (_: foundCharacters:)
    - parser:foundCharacters:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, foundCharacters string: String!)

Objective C

- (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string

Параметры

`parser`	Объект синтаксического анализатора.
`string`	Строка, представляющая полное или частичное текстовое содержание элемента тока.

Обсуждение

Объект синтаксического анализатора может отправить делегату несколько parser:foundCharacters: сообщения для создания отчетов о символах элемента. Поскольку string может быть только часть общего символьного содержания для элемента тока, необходимо добавить его к текущему накоплению символов, пока не изменяется элемент.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.


    
    синтаксический анализатор (_: foundIgnorableWhitespace:)
    - parser:foundIgnorableWhitespace:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, foundIgnorableWhitespace whitespaceString: String!)

Objective C

- (void)parser:(NSXMLParser *)parser foundIgnorableWhitespace:(NSString *)whitespaceString

Параметры

`parser`	Объект синтаксического анализатора.
`whitespaceString`	Строка, представляющая все или часть игнорируемых пробельных символов элемента тока.

Обсуждение

Все пробельные символы элемента (включая возвраты каретки, вкладки и символы новой строки) не могут быть предоставлены через отдельный вызов этого метода. Синтаксический анализатор может отправить делегату несколько parser:foundIgnorableWhitespace: сообщения для создания отчетов о пробельных символах элемента. Необходимо добавить символы в каждом вызове к текущему накоплению символов.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:foundCharacters:


    
    синтаксический анализатор (_: foundProcessingInstructionWithTarget:data:)
    - parser:foundProcessingInstructionWithTarget:data:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, foundProcessingInstructionWithTarget target: String!, data data: String!)

Objective C

- (void)parser:(NSXMLParser *)parser foundProcessingInstructionWithTarget:(NSString *)target data:(NSString *)data

Параметры

`parser`	Объект синтаксического анализатора.
`target`	Строка, представляющая цель инструкции обработки.
`data`	Строка, представляющая данные для инструкции обработки.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.


    
    синтаксический анализатор (_: foundComment:)
    - parser:foundComment:

Отправленный синтаксическим анализатором возражают против его делегата, когда он встречается с комментарием в XML.

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, foundComment comment: String!)

Objective C

- (void)parser:(NSXMLParser *)parser foundComment:(NSString *)comment

Параметры

`parser`	`NSXMLParser` объект, анализирующий XML.
`comment`	Строка, которая является содержанием комментария в XML.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.


    
    синтаксический анализатор (_: foundCDATA:)
    - parser:foundCDATA:

Отправленный синтаксическим анализатором возражают против его делегата, когда он встречается с блоком CDATA.

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, foundCDATA CDATABlock: NSData!)

Objective C

- (void)parser:(NSXMLParser *)parser foundCDATA:(NSData *)CDATABlock

Параметры

`parser`	`NSXMLParser` объект, анализирующий XML.
`CDATABlock`	Объект данных, содержащий блок CDATA.

Обсуждение

Через этот метод объект синтаксического анализатора передает содержание блока его делегату в NSData объект. Блок CDATA является символьными данными, проигнорированными синтаксическим анализатором. Кодирование символьных данных является UTF-8. Для преобразования объекта данных в строковый объект используйте NSString метод initWithData:encoding:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

Обработка DTD


    
    синтаксический анализатор (_: foundAttributeDeclarationWithName:forElement:type:defaultValue:)
    - parser:foundAttributeDeclarationWithName:forElement:type:defaultValue:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, foundAttributeDeclarationWithName attributeName: String!, forElement elementName: String!, type type: String!, defaultValue defaultValue: String!)

Objective C

- (void)parser:(NSXMLParser *)parser foundAttributeDeclarationWithName:(NSString *)attributeName forElement:(NSString *)elementName type:(NSString *)type defaultValue:(NSString *)defaultValue

Параметры

`parser`	`NSXMLParser` объект, анализирующий XML.
`attributeName`	Строка, которая является именем атрибута.
`elementName`	Строка, которая является именем элемента, имеющего атрибут `attributeName`.
`type`	Строка, такая как «ENTITY», «NOTATION» или «ID», указывающий тип атрибута.
`defaultValue`	Строка, указывающая значение по умолчанию атрибута.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:didStartElement:namespaceURI:qualifiedName:attributes:


    
    синтаксический анализатор (_: foundElementDeclarationWithName:model:)
    - parser:foundElementDeclarationWithName:model:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, foundElementDeclarationWithName elementName: String!, model model: String!)

Objective C

- (void)parser:(NSXMLParser *)parser foundElementDeclarationWithName:(NSString *)elementName model:(NSString *)model

Параметры

`parser`	`NSXMLParser` объект, анализирующий XML.
`elementName`	Строка, которая является именем элемента.
`model`	Строка, указывающая модель для `elementName`.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:didStartElement:namespaceURI:qualifiedName:attributes:


    
    синтаксический анализатор (_: foundExternalEntityDeclarationWithName:publicID:systemID:)
    - parser:foundExternalEntityDeclarationWithName:publicID:systemID:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, foundExternalEntityDeclarationWithName entityName: String!, publicID publicID: String!, systemID systemID: String!)

Objective C

- (void)parser:(NSXMLParser *)parser foundExternalEntityDeclarationWithName:(NSString *)entityName publicID:(NSString *)publicID systemID:(NSString *)systemID

Параметры

`parser`	`NSXMLParser` объект, анализирующий XML.
`entityName`	Строка, которая является именем объекта.
`publicID`	Строка, указывающая общедоступный ID, связанный с `entityName`.
`systemID`	Строка, указывающая систему ID, связанный с `entityName`.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:foundInternalEntityDeclarationWithName:value:
– parser:foundUnparsedEntityDeclarationWithName:publicID:systemID:notationName:
– parser:resolveExternalEntityName:systemID:


    
    синтаксический анализатор (_: foundInternalEntityDeclarationWithName:value:)
    - parser:foundInternalEntityDeclarationWithName:value:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, foundInternalEntityDeclarationWithName name: String!, value value: String!)

Objective C

- (void)parser:(NSXMLParser *)parser foundInternalEntityDeclarationWithName:(NSString *)name value:(NSString *)value

Параметры

`parser`	`NSXMLParser` объект, анализирующий XML.
`name`	Строка, которая является заявленным именем внутреннего объекта.
`value`	Строка, которая является значением объекта `name`.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:foundExternalEntityDeclarationWithName:publicID:systemID:
– parser:foundUnparsedEntityDeclarationWithName:publicID:systemID:notationName:


    
    синтаксический анализатор (_: foundUnparsedEntityDeclarationWithName:publicID:systemID:notationName:)
    - parser:foundUnparsedEntityDeclarationWithName:publicID:systemID:notationName:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, foundUnparsedEntityDeclarationWithName name: String!, publicID publicID: String!, systemID systemID: String!, notationName notationName: String!)

Objective C

- (void)parser:(NSXMLParser *)parser foundUnparsedEntityDeclarationWithName:(NSString *)name publicID:(NSString *)publicID systemID:(NSString *)systemID notationName:(NSString *)notationName

Параметры

`parser`	`NSXMLParser` объект, анализирующий XML.
`name`	Строка, которая является именем непроанализированного объекта в объявлении.
`publicID`	Строка, указывающая общедоступный ID, связалась с объектом `name`.
`systemID`	Строка, указывающая систему ID, связалась с объектом `name`.
`notationName`	Строка, указывающая нотацию объявления объекта `name`.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– parser:foundExternalEntityDeclarationWithName:publicID:systemID:
– parser:foundInternalEntityDeclarationWithName:value:
– parser:resolveExternalEntityName:systemID:


    
    синтаксический анализатор (_: foundNotationDeclarationWithName:publicID:systemID:)
    - parser:foundNotationDeclarationWithName:publicID:systemID:

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

Объявление

Swift

optional func parser(_ parser: NSXMLParser!, foundNotationDeclarationWithName name: String!, publicID publicID: String!, systemID systemID: String!)

Objective C

- (void)parser:(NSXMLParser *)parser foundNotationDeclarationWithName:(NSString *)name publicID:(NSString *)publicID systemID:(NSString *)systemID

Параметры

`parser`	`NSXMLParser` объект, анализирующий XML.
`name`	Строка, которая является именем нотации.
`publicID`	Строка, указывающая общедоступный ID, связалась с нотацией `name`.
`systemID`	Строка, указывающая систему ID, связалась с нотацией `name`.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.