/usr/include/xercesc/sax/SAXParseException.hpp is in libxerces-c2-dev 2.8.0+deb1-3build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 | /*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* $Id: SAXParseException.hpp 568078 2007-08-21 11:43:25Z amassari $
*/
#ifndef SAXPARSEEXCEPTION_HPP
#define SAXPARSEEXCEPTION_HPP
#include <xercesc/sax/SAXException.hpp>
XERCES_CPP_NAMESPACE_BEGIN
class Locator;
/**
* Encapsulate an XML parse error or warning.
*
* <p>This exception will include information for locating the error
* in the original XML document. Note that although the application
* will receive a SAXParseException as the argument to the handlers
* in the ErrorHandler interface, the application is not actually
* required to throw the exception; instead, it can simply read the
* information in it and take a different action.</p>
*
* <p>Since this exception is a subclass of SAXException, it
* inherits the ability to wrap another exception.</p>
*
* @see SAXException#SAXException
* @see Locator#Locator
* @see ErrorHandler#ErrorHandler
*/
class SAX_EXPORT SAXParseException : public SAXException
{
public:
/** @name Constructors and Destructor */
//@{
/**
* Create a new SAXParseException from a message and a Locator.
*
* <p>This constructor is especially useful when an application is
* creating its own exception from within a DocumentHandler
* callback.</p>
*
* @param message The error or warning message.
* @param locator The locator object for the error or warning.
* @param manager Pointer to the memory manager to be used to
* allocate objects.
* @see Locator#Locator
* @see Parser#setLocale
*/
SAXParseException(const XMLCh* const message, const Locator& locator,
MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager);
/**
* Create a new SAXParseException.
*
* <p>This constructor is most useful for parser writers.</p>
*
* <p>If the system identifier is a URL, the parser must resolve it
* fully before creating the exception.</p>
*
* @param message The error or warning message.
* @param publicId The public identifer of the entity that generated
* the error or warning.
* @param systemId The system identifer of the entity that generated
* the error or warning.
* @param lineNumber The line number of the end of the text that
* caused the error or warning.
* @param columnNumber The column number of the end of the text that
* caused the error or warning.
* @param manager Pointer to the memory manager to be used to
* allocate objects.
* @see Parser#setLocale
*/
SAXParseException
(
const XMLCh* const message
, const XMLCh* const publicId
, const XMLCh* const systemId
, const XMLSSize_t lineNumber
, const XMLSSize_t columnNumber
, MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager
);
/**
* Copy constructor
*
* @param toCopy The object to be copied
*/
SAXParseException(const SAXParseException& toCopy);
/**
* Destructor
*/
~SAXParseException();
//@}
/** @name Assignment operator */
//@{
/**
* Assignment operator
*
* @param toAssign The object to be copied through assignment
*
*/
SAXParseException& operator=(const SAXParseException& toAssign);
//@}
/** @name Getter methods */
//@{
/**
* The column number of the end of the text where the exception occurred.
*
* <p>The first column in a line is position 1.</p>
*
* @return An integer representing the column number, or -1
* if none is available.
* @see Locator#getColumnNumber
*/
XMLSSize_t getColumnNumber() const;
/**
* The line number of the end of the text where the exception occurred.
*
* @return An integer representing the line number, or -1
* if none is available.
* @see Locator#getLineNumber
*/
XMLSSize_t getLineNumber() const;
/**
* Get the public identifier of the entity where the exception occurred.
*
* @return A string containing the public identifier, or null
* if none is available.
* @see Locator#getPublicId
*/
const XMLCh* getPublicId() const;
/**
* Get the system identifier of the entity where the exception occurred.
*
* <p>If the system identifier is a URL, it will be resolved
* fully.</p>
*
* @return A string containing the system identifier, or null
* if none is available.
* @see Locator#getSystemId
*/
const XMLCh* getSystemId() const;
//@}
private:
/* Data Members */
/* The column in the source text where the error occured. */
XMLSSize_t fColumnNumber;
/* The line in the source text where the error occured. */
XMLSSize_t fLineNumber;
/* The public id of the file where the error occured. */
XMLCh* fPublicId;
/* The system id of the file where the error occured. */
XMLCh* fSystemId;
};
XERCES_CPP_NAMESPACE_END
#endif
|