Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/java/sql/DataTruncation#pubctors) \| [Methods](https://developer.android.com/reference/java/sql/DataTruncation#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/java/sql/DataTruncation#inhmethods)
# DataTruncation
`
public
class
DataTruncation
`
`
`
`
`
`
`
`
`
`
extends https://developer.android.com/reference/java/sql/SQLWarning
`
`
`
|---|---|---|---|---|---|
| [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.sql.SQLException](https://developer.android.com/reference/java/sql/SQLException) |||
| | | | ↳ | [java.sql.SQLWarning](https://developer.android.com/reference/java/sql/SQLWarning) ||
| | | | | ↳ | java.sql.DataTruncation |
*** ** * ** ***
An exception thrown as a `DataTruncation` exception
(on writes) or reported as a
`DataTruncation` warning (on reads)
when a data values is unexpectedly truncated for reasons other than its having
execeeded `MaxFieldSize`.
The SQLstate for a `DataTruncation` during read is `01004`.
The SQLstate for a `DataTruncation` during write is `22001`.
## Summary
| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/java/sql/DataTruncation#DataTruncation(int,%20boolean,%20boolean,%20int,%20int)(int index, boolean parameter, boolean read, int dataSize, int transferSize) ` Creates a `DataTruncation` object with the SQLState initialized to 01004 when `read` is set to `true` and 22001 when `read` is set to `false`, the reason set to "Data truncation", the vendor code set to 0, and the other fields set to the given values. |
| ` https://developer.android.com/reference/java/sql/DataTruncation#DataTruncation(int,%20boolean,%20boolean,%20int,%20int,%20java.lang.Throwable)(int index, boolean parameter, boolean read, int dataSize, int transferSize, https://developer.android.com/reference/java/lang/Throwable cause) ` Creates a `DataTruncation` object with the SQLState initialized to 01004 when `read` is set to `true` and 22001 when `read` is set to `false`, the reason set to "Data truncation", the vendor code set to 0, and the other fields set to the given values. |
| ### Public methods ||
|---|---|
| ` int` | ` https://developer.android.com/reference/java/sql/DataTruncation#getDataSize()() ` Gets the number of bytes of data that should have been transferred. |
| ` int` | ` https://developer.android.com/reference/java/sql/DataTruncation#getIndex()() ` Retrieves the index of the column or parameter that was truncated. |
| ` boolean` | ` https://developer.android.com/reference/java/sql/DataTruncation#getParameter()() ` Indicates whether the value truncated was a parameter value or a column value. |
| ` boolean` | ` https://developer.android.com/reference/java/sql/DataTruncation#getRead()() ` Indicates whether or not the value was truncated on a read. |
| ` int` | ` https://developer.android.com/reference/java/sql/DataTruncation#getTransferSize()() ` Gets the number of bytes of data actually transferred. |
| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/java/sql/SQLWarning ` |---|---| | ` https://developer.android.com/reference/java/sql/SQLWarning` | ` https://developer.android.com/reference/java/sql/SQLWarning#getNextWarning()() ` Retrieves the warning chained to this `SQLWarning` object by `setNextWarning`. | | ` void` | ` https://developer.android.com/reference/java/sql/SQLWarning#setNextWarning(java.sql.SQLWarning)(https://developer.android.com/reference/java/sql/SQLWarning w) ` Adds a `SQLWarning` object to the end of the chain. | ||
| From class ` https://developer.android.com/reference/java/sql/SQLException ` |---|---| | ` int` | ` https://developer.android.com/reference/java/sql/SQLException#getErrorCode()() ` Retrieves the vendor-specific exception code for this `SQLException` object. | | ` https://developer.android.com/reference/java/sql/SQLException` | ` https://developer.android.com/reference/java/sql/SQLException#getNextException()() ` Retrieves the exception chained to this `SQLException` object by setNextException(SQLException ex). | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/sql/SQLException#getSQLState()() ` Retrieves the SQLState for this `SQLException` object. | | ` https://developer.android.com/reference/java/util/Iterator` | ` https://developer.android.com/reference/java/sql/SQLException#iterator()() ` Returns an iterator over the chained SQLExceptions. | | ` void` | ` https://developer.android.com/reference/java/sql/SQLException#setNextException(java.sql.SQLException)(https://developer.android.com/reference/java/sql/SQLException ex) ` Adds an `SQLException` object to the end of the chain. | ||
| 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*. | ||
| From interface ` https://developer.android.com/reference/java/lang/Iterable ` |---|---| | ` default void` | ` https://developer.android.com/reference/java/lang/Iterable#forEach(java.util.function.Consumer)(https://developer.android.com/reference/java/util/function/Consumer action) ` Performs the given action for each element of the `Iterable` until all elements have been processed or the action throws an exception. | | ` abstract https://developer.android.com/reference/java/util/Iterator` | ` https://developer.android.com/reference/java/lang/Iterable#iterator()() ` Returns an iterator over elements of type `T`. | | ` default https://developer.android.com/reference/java/util/Spliterator` | ` https://developer.android.com/reference/java/lang/Iterable#spliterator()() ` Creates a `https://developer.android.com/reference/java/util/Spliterator` over the elements described by this `Iterable`. | ||
## Public constructors
### DataTruncation
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public DataTruncation (int index,
boolean parameter,
boolean read,
int dataSize,
int transferSize)
```
Creates a `DataTruncation` object
with the SQLState initialized
to 01004 when `read` is set to `true` and 22001
when `read` is set to `false`,
the reason set to "Data truncation", the
vendor code set to 0, and
the other fields set to the given values.
The `cause` is not initialized, and may subsequently be
initialized by a call to the
`https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)` method.
| Parameters ||
|---|---|
| `index` | `int`: The index of the parameter or column value
|
| `parameter` | `boolean`: true if a parameter value was truncated
|
| `read` | `boolean`: true if a read was truncated
|
| `dataSize` | `int`: the original size of the data
|
| `transferSize` | `int`: the size after truncation
|
### DataTruncation
Added in [API level 9](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public DataTruncation (int index,
boolean parameter,
boolean read,
int dataSize,
int transferSize,
Throwable cause)
```
Creates a `DataTruncation` object
with the SQLState initialized
to 01004 when `read` is set to `true` and 22001
when `read` is set to `false`,
the reason set to "Data truncation", the
vendor code set to 0, and
the other fields set to the given values.
| Parameters ||
|---|---|
| `index` | `int`: The index of the parameter or column value
|
| `parameter` | `boolean`: true if a parameter value was truncated
|
| `read` | `boolean`: true if a read was truncated
|
| `dataSize` | `int`: the original size of the data
|
| `transferSize` | `int`: the size after truncation
|
| `cause` | `Throwable`: the underlying reason for this `DataTruncation` (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown.
|
## Public methods
### getDataSize
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getDataSize ()
```
Gets the number of bytes of data that should have been transferred.
This number may be approximate if data conversions were being
performed. The value may be `-1` if the size is unknown.
| Returns ||
|---|---|
| `int` | the number of bytes of data that should have been transferred
|
### getIndex
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getIndex ()
```
Retrieves the index of the column or parameter that was truncated.
This may be -1 if the column or parameter index is unknown, in
which case the `parameter` and `read` fields should be ignored.
| Returns ||
|---|---|
| `int` | the index of the truncated paramter or column value
|
### getParameter
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean getParameter ()
```
Indicates whether the value truncated was a parameter value or
a column value.
| Returns ||
|---|---|
| `boolean` | `true` if the value truncated was a parameter; `false` if it was a column value
|
### getRead
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean getRead ()
```
Indicates whether or not the value was truncated on a read.
| Returns ||
|---|---|
| `boolean` | `true` if the value was truncated when read from the database; `false` if the data was truncated on a write
|
### getTransferSize
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getTransferSize ()
```
Gets the number of bytes of data actually transferred.
The value may be `-1` if the size is unknown.
| Returns ||
|---|---|
| `int` | the number of bytes of data actually transferred
|