Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Constants](https://developer.android.com/reference/android/icu/text/StringPrepParseException#constants) \| [Ctors](https://developer.android.com/reference/android/icu/text/StringPrepParseException#pubctors) \| [Methods](https://developer.android.com/reference/android/icu/text/StringPrepParseException#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/icu/text/StringPrepParseException#inhmethods)

# StringPrepParseException

*** ** * ** ***

` public class StringPrepParseException `   
` ` ` ` ` ` ` extends https://developer.android.com/reference/java/text/ParseException ` ` `

|---|---|---|---|---|
| [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) |||
|   |   | ↳ | [java.text.ParseException](https://developer.android.com/reference/java/text/ParseException) ||
|   |   |   | ↳ | android.icu.text.StringPrepParseException |

<br />

*** ** * ** ***

Exception that signals an error has occurred while parsing the input to StringPrep or IDNA.

## Summary

| ### Constants ||
|---|---|
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#ACE_PREFIX_ERROR` <br /> |
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#BUFFER_OVERFLOW_ERROR` <br /> |
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#CHECK_BIDI_ERROR` <br /> |
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#DOMAIN_NAME_TOO_LONG_ERROR` <br /> |
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#ILLEGAL_CHAR_FOUND` <br /> |
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#INVALID_CHAR_FOUND` <br /> |
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#LABEL_TOO_LONG_ERROR` <br /> |
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#PROHIBITED_ERROR` <br /> |
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#STD3_ASCII_RULES_ERROR` <br /> |
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#UNASSIGNED_ERROR` <br /> |
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#VERIFICATION_ERROR` <br /> |
| `int` | `https://developer.android.com/reference/android/icu/text/StringPrepParseException#ZERO_LENGTH_LABEL` <br /> |

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/icu/text/StringPrepParseException#StringPrepParseException(java.lang.String,%20int)(https://developer.android.com/reference/java/lang/String message, int error) ` Construct a ParseException object with the given message and error code |
| ` https://developer.android.com/reference/android/icu/text/StringPrepParseException#StringPrepParseException(java.lang.String,%20int,%20java.lang.String,%20int)(https://developer.android.com/reference/java/lang/String message, int error, https://developer.android.com/reference/java/lang/String rules, int pos) ` Construct a ParseException object with the given message and error code |
| ` https://developer.android.com/reference/android/icu/text/StringPrepParseException#StringPrepParseException(java.lang.String,%20int,%20java.lang.String,%20int,%20int)(https://developer.android.com/reference/java/lang/String message, int error, https://developer.android.com/reference/java/lang/String rules, int pos, int lineNumber) ` Construct a ParseException object with the given message and error code |

| ### Public methods ||
|---|---|
| ` boolean` | ` https://developer.android.com/reference/android/icu/text/StringPrepParseException#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object other) ` Compare this ParseException to another and evaluate if they are equal. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/StringPrepParseException#getError()() ` Returns the error code of this exception. |
| ` int` | ` https://developer.android.com/reference/android/icu/text/StringPrepParseException#hashCode()() ` Mock implementation of hashCode(). |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/icu/text/StringPrepParseException#toString()() ` Returns the position of error in the rules string |

### Inherited methods

From class ` https://developer.android.com/reference/java/text/ParseException ` ` int` ` https://developer.android.com/reference/java/text/ParseException#getErrorOffset()() `

Returns the position where the error was found.
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*.

## Constants

### ACE_PREFIX_ERROR

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

```
public static final int ACE_PREFIX_ERROR
```

<br />

<br />

Constant Value: 6 (0x00000006)

### BUFFER_OVERFLOW_ERROR

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

```
public static final int BUFFER_OVERFLOW_ERROR
```

<br />

<br />

Constant Value: 9 (0x00000009)

### CHECK_BIDI_ERROR

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

```
public static final int CHECK_BIDI_ERROR
```

<br />

<br />

Constant Value: 4 (0x00000004)

### DOMAIN_NAME_TOO_LONG_ERROR

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

```
public static final int DOMAIN_NAME_TOO_LONG_ERROR
```

<br />

<br />

Constant Value: 11 (0x0000000b)

### ILLEGAL_CHAR_FOUND

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

```
public static final int ILLEGAL_CHAR_FOUND
```

<br />

<br />

Constant Value: 1 (0x00000001)

### INVALID_CHAR_FOUND

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

```
public static final int INVALID_CHAR_FOUND
```

<br />

<br />

Constant Value: 0 (0x00000000)

### LABEL_TOO_LONG_ERROR

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

```
public static final int LABEL_TOO_LONG_ERROR
```

<br />

<br />

Constant Value: 8 (0x00000008)

### PROHIBITED_ERROR

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

```
public static final int PROHIBITED_ERROR
```

<br />

<br />

Constant Value: 2 (0x00000002)

### STD3_ASCII_RULES_ERROR

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

```
public static final int STD3_ASCII_RULES_ERROR
```

<br />

<br />

Constant Value: 5 (0x00000005)

### UNASSIGNED_ERROR

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

```
public static final int UNASSIGNED_ERROR
```

<br />

<br />

Constant Value: 3 (0x00000003)

### VERIFICATION_ERROR

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

```
public static final int VERIFICATION_ERROR
```

<br />

<br />

Constant Value: 7 (0x00000007)

### ZERO_LENGTH_LABEL

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

```
public static final int ZERO_LENGTH_LABEL
```

<br />

<br />

Constant Value: 10 (0x0000000a)

## Public constructors

### StringPrepParseException

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

```
public StringPrepParseException (String message, 
                int error)
```

Construct a ParseException object with the given message and error code

<br />

| Parameters ||
|---|---|
| `message` | `String`: A string describing the type of error that occurred <br /> |
| `error` | `int`: The error that has occurred <br /> |

### StringPrepParseException

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

```
public StringPrepParseException (String message, 
                int error, 
                String rules, 
                int pos)
```

Construct a ParseException object with the given message and error code

<br />

| Parameters ||
|---|---|
| `message` | `String`: A string describing the type of error that occurred <br /> |
| `error` | `int`: The error that has occurred <br /> |
| `rules` | `String`: The input rules string <br /> |
| `pos` | `int`: The position of error in the rules string <br /> |

### StringPrepParseException

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

```
public StringPrepParseException (String message, 
                int error, 
                String rules, 
                int pos, 
                int lineNumber)
```

Construct a ParseException object with the given message and error code

<br />

| Parameters ||
|---|---|
| `message` | `String`: A string describing the type of error that occurred <br /> |
| `error` | `int`: The error that has occurred <br /> |
| `rules` | `String`: The input rules string <br /> |
| `pos` | `int`: The position of error in the rules string <br /> |
| `lineNumber` | `int`: The line number at which the error has occurred. If the parse engine is not using this field, it should set it to zero. Otherwise it should be a positive integer. The default value of this field is -1. It will be set to 0 if the code populating this struct is not using line numbers. <br /> |

## Public methods

### equals

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

```
public boolean equals (Object other)
```

Compare this ParseException to another and evaluate if they are equal. The comparison works only on the type of error and does not compare the rules strings, if any, for equality.

<br />

| Parameters ||
|---|---|
| `other` | `Object`: The exception that this object should be compared to <br /> |

| Returns ||
|---|---|
| `boolean` | true if the objects are equal, false if unequal <br /> |

### getError

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

```
public int getError ()
```

Returns the error code of this exception. This method is only used for testing to verify the error.

<br />

| Returns ||
|---|---|
| `int` | The error code <br /> |

### hashCode

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

```
public int hashCode ()
```

Mock implementation of hashCode(). This implementation always returns a constant value. When Java assertion is enabled, this method triggers an assertion failure.

<br />

| Returns ||
|---|---|
| `int` | a hash code value for this object. <br /> |

### toString

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

```
public String toString ()
```

Returns the position of error in the rules string

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | String <br /> |