Swiftdiff options
Diffstat (limited to 'Swiften/Parser/XMLParserClient.h')
| -rw-r--r-- | Swiften/Parser/XMLParserClient.h | 34 |
1 files changed, 24 insertions, 10 deletions
diff --git a/Swiften/Parser/XMLParserClient.h b/Swiften/Parser/XMLParserClient.h index 956eacf..2f0bc9e 100644 --- a/Swiften/Parser/XMLParserClient.h +++ b/Swiften/Parser/XMLParserClient.h @@ -1,7 +1,7 @@ /* - * Copyright (c) 2010 Remko Tronçon - * Licensed under the GNU General Public License v3. - * See Documentation/Licenses/GPLv3.txt for more information. + * Copyright (c) 2010-2019 Isode Limited. + * All rights reserved. + * See the COPYING file for more information. */ #pragma once @@ -10,12 +10,26 @@ #include <Swiften/Parser/AttributeMap.h> namespace Swift { - class SWIFTEN_API XMLParserClient { - public: - virtual ~XMLParserClient(); + class SWIFTEN_API XMLParserClient { + public: + virtual ~XMLParserClient(); - virtual void handleStartElement(const std::string& element, const std::string& ns, const AttributeMap& attributes) = 0; - virtual void handleEndElement(const std::string& element, const std::string& ns) = 0; - virtual void handleCharacterData(const std::string& data) = 0; - }; + /** + * Client will have to implement only one of the following methods depending on whether + * he is interested in processing the element prefix or not. + */ + virtual void handleStartElement(const std::string& element, const std::string& ns, const AttributeMap& attributes); + virtual void handleStartElementPrefix(const std::string& prefix, const std::string& uri, const std::string& element, const AttributeMap& attributes); + + virtual void handleEndElement(const std::string& element, const std::string& ns) = 0; + virtual void handleCharacterData(const std::string& data) = 0; + + /** + * Signal that a namespace prefix has been declared + * This callback might be called multiple times for a single element, + * and will trigger before the corresponding \ref handleStartElement + * is called. + */ + virtual void handleNamespaceDeclaration(const std::string& prefix, const std::string& uri); + }; } |