Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/org/xml/sax/SAXParseException#pubctors) \| [Methods](https://developer.android.com/reference/org/xml/sax/SAXParseException#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/org/xml/sax/SAXParseException#inhmethods)

# SAXParseException


`
public


class
SAXParseException
`


`


`

`


`

`


`

`

extends https://developer.android.com/reference/org/xml/sax/SAXException


`

`


`

|---|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||||
| ↳ | [java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable) ||||
|   | ↳ | [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception) |||
|   |   | ↳ | [org.xml.sax.SAXException](https://developer.android.com/reference/org/xml/sax/SAXException) ||
|   |   |   | ↳ | org.xml.sax.SAXParseException |

<br />

*** ** * ** ***

Encapsulate an XML parse error or warning.

> *This module, both source code and documentation, is in the
> Public Domain, and comes with **NO WARRANTY**.* See <http://www.saxproject.org> for further information.

This exception may include information for locating the error
in the original XML document, as if it came from a `https://developer.android.com/reference/org/xml/sax/Locator`
object. Note that although the application
will receive a SAXParseException as the argument to the handlers
in the `https://developer.android.com/reference/org/xml/sax/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.

Since this exception is a subclass of `https://developer.android.com/reference/org/xml/sax/SAXException`, it inherits the ability to wrap another exception.

<br />

**See also:**

- `https://developer.android.com/reference/org/xml/sax/SAXException`
- `https://developer.android.com/reference/org/xml/sax/Locator`
- `https://developer.android.com/reference/org/xml/sax/ErrorHandler`

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/org/xml/sax/SAXParseException#SAXParseException(java.lang.String,%20java.lang.String,%20java.lang.String,%20int,%20int)(https://developer.android.com/reference/java/lang/String message, https://developer.android.com/reference/java/lang/String publicId, https://developer.android.com/reference/java/lang/String systemId, int lineNumber, int columnNumber) ` Create a new SAXParseException. |
| ` https://developer.android.com/reference/org/xml/sax/SAXParseException#SAXParseException(java.lang.String,%20java.lang.String,%20java.lang.String,%20int,%20int,%20java.lang.Exception)(https://developer.android.com/reference/java/lang/String message, https://developer.android.com/reference/java/lang/String publicId, https://developer.android.com/reference/java/lang/String systemId, int lineNumber, int columnNumber, https://developer.android.com/reference/java/lang/Exception e) ` Create a new SAXParseException with an embedded exception. |
| ` https://developer.android.com/reference/org/xml/sax/SAXParseException#SAXParseException(java.lang.String,%20org.xml.sax.Locator)(https://developer.android.com/reference/java/lang/String message, https://developer.android.com/reference/org/xml/sax/Locator locator) ` Create a new SAXParseException from a message and a Locator. |
| ` https://developer.android.com/reference/org/xml/sax/SAXParseException#SAXParseException(java.lang.String,%20org.xml.sax.Locator,%20java.lang.Exception)(https://developer.android.com/reference/java/lang/String message, https://developer.android.com/reference/org/xml/sax/Locator locator, https://developer.android.com/reference/java/lang/Exception e) ` Wrap an existing exception in a SAXParseException. |

| ### Public methods ||
|---|---|
| ` int` | ` https://developer.android.com/reference/org/xml/sax/SAXParseException#getColumnNumber()() ` The column number of the end of the text where the exception occurred. |
| ` int` | ` https://developer.android.com/reference/org/xml/sax/SAXParseException#getLineNumber()() ` The line number of the end of the text where the exception occurred. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/org/xml/sax/SAXParseException#getPublicId()() ` Get the public identifier of the entity where the exception occurred. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/org/xml/sax/SAXParseException#getSystemId()() ` Get the system identifier of the entity where the exception occurred. |

### Inherited methods

From class `

https://developer.android.com/reference/org/xml/sax/SAXException

` `


https://developer.android.com/reference/java/lang/Exception` `
https://developer.android.com/reference/org/xml/sax/SAXException#getException()()
`

Return the embedded exception, if any.


`


https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/org/xml/sax/SAXException#getMessage()()
`

Return a detail message for this exception.


`


https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/org/xml/sax/SAXException#toString()()
`

Override toString to pick up any embedded exception.


From class `

https://developer.android.com/reference/java/lang/Throwable

` `


final

void` `
https://developer.android.com/reference/java/lang/Throwable#addSuppressed(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable exception)
`

Appends the specified exception to the exceptions that were
suppressed in order to deliver this exception.


`


https://developer.android.com/reference/java/lang/Throwable` `
https://developer.android.com/reference/java/lang/Throwable#fillInStackTrace()()
`

Fills in the execution stack trace.


`


https://developer.android.com/reference/java/lang/Throwable` `
https://developer.android.com/reference/java/lang/Throwable#getCause()()
`

Returns the cause of this throwable or `null` if the
cause is nonexistent or unknown.


`


https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage()()
`

Creates a localized description of this throwable.


`


https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/java/lang/Throwable#getMessage()()
`

Returns the detail message string of this throwable.


`


https://developer.android.com/reference/java/lang/StackTraceElement` `
https://developer.android.com/reference/java/lang/Throwable#getStackTrace()()
`

Provides programmatic access to the stack trace information printed by
`https://developer.android.com/reference/java/lang/Throwable#printStackTrace()`.


`


final

https://developer.android.com/reference/java/lang/Throwable` `
https://developer.android.com/reference/java/lang/Throwable#getSuppressed()()
`

Returns an array containing all of the exceptions that were
suppressed, typically by the `try`-with-resources
statement, in order to deliver this exception.


`


https://developer.android.com/reference/java/lang/Throwable` `
https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable cause)
`

Initializes the *cause* of this throwable to the specified value.


`


void` `
https://developer.android.com/reference/java/lang/Throwable#printStackTrace()()
`

Prints this throwable and its backtrace to the
standard error stream.


`


void` `
https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintWriter)(https://developer.android.com/reference/java/io/PrintWriter s)
`

Prints this throwable and its backtrace to the specified
print writer.


`


void` `
https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintStream)(https://developer.android.com/reference/java/io/PrintStream s)
`

Prints this throwable and its backtrace to the specified print stream.


`


void` `
https://developer.android.com/reference/java/lang/Throwable#setStackTrace(java.lang.StackTraceElement[])(https://developer.android.com/reference/java/lang/StackTraceElement stackTrace)
`

Sets the stack trace elements that will be returned by
`https://developer.android.com/reference/java/lang/Throwable#getStackTrace()` and printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()`
and related methods.


`


https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/java/lang/Throwable#toString()()
`

Returns a short description of this throwable.


From class `

https://developer.android.com/reference/java/lang/Object

` `


https://developer.android.com/reference/java/lang/Object` `
https://developer.android.com/reference/java/lang/Object#clone()()
`

Creates and returns a copy of this object.


`


boolean` `
https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj)
`

Indicates whether some other object is "equal to" this one.


`


void` `
https://developer.android.com/reference/java/lang/Object#finalize()()
`

Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.


`


final

https://developer.android.com/reference/java/lang/Class<?>` `
https://developer.android.com/reference/java/lang/Object#getClass()()
`

Returns the runtime class of this `Object`.


`


int` `
https://developer.android.com/reference/java/lang/Object#hashCode()()
`

Returns a hash code value for the object.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#notify()()
`

Wakes up a single thread that is waiting on this object's
monitor.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#notifyAll()()
`

Wakes up all threads that are waiting on this object's monitor.


`


https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/java/lang/Object#toString()()
`

Returns a string representation of the object.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos)
`

Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*, or until a
certain amount of real time has elapsed.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis)
`

Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*, or until a
certain amount of real time has elapsed.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#wait()()
`

Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*.


## Public constructors

### SAXParseException

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SAXParseException (String message, 
                String publicId, 
                String systemId, 
                int lineNumber, 
                int columnNumber)
```

Create a new SAXParseException.

This constructor is most useful for parser writers.

All parameters except the message are as if
they were provided by a `https://developer.android.com/reference/org/xml/sax/Locator`. For example, if the
system identifier is a URL (including relative filename), the
caller must resolve it fully before creating the exception.

<br />

<br />

| Parameters ||
|---|---|
| `message` | `String`: The error or warning message. <br /> |
| `publicId` | `String`: The public identifier of the entity that generated the error or warning. <br /> |
| `systemId` | `String`: The system identifier of the entity that generated the error or warning. <br /> |
| `lineNumber` | `int`: The line number of the end of the text that caused the error or warning. <br /> |
| `columnNumber` | `int`: The column number of the end of the text that cause the error or warning. <br /> |

### SAXParseException

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SAXParseException (String message, 
                String publicId, 
                String systemId, 
                int lineNumber, 
                int columnNumber, 
                Exception e)
```

Create a new SAXParseException with an embedded exception.

This constructor is most useful for parser writers who
need to wrap an exception that is not a subclass of
`https://developer.android.com/reference/org/xml/sax/SAXException`.

All parameters except the message and exception are as if
they were provided by a `https://developer.android.com/reference/org/xml/sax/Locator`. For example, if the
system identifier is a URL (including relative filename), the
caller must resolve it fully before creating the exception.

<br />

<br />

| Parameters ||
|---|---|
| `message` | `String`: The error or warning message, or null to use the message from the embedded exception. <br /> |
| `publicId` | `String`: The public identifier of the entity that generated the error or warning. <br /> |
| `systemId` | `String`: The system identifier of the entity that generated the error or warning. <br /> |
| `lineNumber` | `int`: The line number of the end of the text that caused the error or warning. <br /> |
| `columnNumber` | `int`: The column number of the end of the text that cause the error or warning. <br /> |
| `e` | `Exception`: Another exception to embed in this one. <br /> |

### SAXParseException

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SAXParseException (String message, 
                Locator locator)
```

Create a new SAXParseException from a message and a Locator.

This constructor is especially useful when an application is
creating its own exception from within a `https://developer.android.com/reference/org/xml/sax/ContentHandler` callback.

<br />

<br />

| Parameters ||
|---|---|
| `message` | `String`: The error or warning message. <br /> |
| `locator` | `Locator`: The locator object for the error or warning (may be null). <br /> |

**See also:**

- `https://developer.android.com/reference/org/xml/sax/Locator`

### SAXParseException

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SAXParseException (String message, 
                Locator locator, 
                Exception e)
```

Wrap an existing exception in a SAXParseException.

This constructor is especially useful when an application is
creating its own exception from within a `https://developer.android.com/reference/org/xml/sax/ContentHandler` callback, and needs to wrap an existing exception that is not a
subclass of `https://developer.android.com/reference/org/xml/sax/SAXException`.

<br />

<br />

| Parameters ||
|---|---|
| `message` | `String`: The error or warning message, or null to use the message from the embedded exception. <br /> |
| `locator` | `Locator`: The locator object for the error or warning (may be null). <br /> |
| `e` | `Exception`: Any exception. <br /> |

**See also:**

- `https://developer.android.com/reference/org/xml/sax/Locator`

## Public methods

### getColumnNumber

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public int getColumnNumber ()
```

The column number of the end of the text where the exception occurred.

The first column in a line is position 1.

<br />

<br />

| Returns ||
|---|---|
| `int` | An integer representing the column number, or -1 if none is available. <br /> |

**See also:**

- `https://developer.android.com/reference/org/xml/sax/Locator#getColumnNumber()`

### getLineNumber

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public int getLineNumber ()
```

The line number of the end of the text where the exception occurred.

The first line is line 1.

<br />

<br />

| Returns ||
|---|---|
| `int` | An integer representing the line number, or -1 if none is available. <br /> |

**See also:**

- `https://developer.android.com/reference/org/xml/sax/Locator#getLineNumber()`

### getPublicId

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String getPublicId ()
```

Get the public identifier of the entity where the exception occurred.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | A string containing the public identifier, or null if none is available. <br /> |

**See also:**

- `https://developer.android.com/reference/org/xml/sax/Locator#getPublicId()`

### getSystemId

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String getSystemId ()
```

Get the system identifier of the entity where the exception occurred.

If the system identifier is a URL, it will have been resolved
fully.

<br />

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | A string containing the system identifier, or null if none is available. <br /> |

**See also:**

- `https://developer.android.com/reference/org/xml/sax/Locator#getSystemId()`