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

# SQLInput

` public interface SQLInput `   
` `

|---|
| java.sql.SQLInput |

<br />

*** ** * ** ***

An input stream that contains a stream of values representing an instance of an SQL structured type or an SQL distinct type. This interface, used only for custom mapping, is used by the driver behind the scenes, and a programmer never directly invokes `SQLInput` methods. The *reader* methods (`readLong`, `readBytes`, and so on) provide a way for an implementation of the `SQLData` interface to read the values in an `SQLInput` object. And as described in `SQLData`, calls to reader methods must be made in the order that their corresponding attributes appear in the SQL definition of the type. The method `wasNull` is used to determine whether the last value read was SQL `NULL`.

When the method `getObject` is called with an object of a class implementing the interface `SQLData`, the JDBC driver calls the method `SQLData.getSQLType` to determine the SQL type of the user-defined type (UDT) being custom mapped. The driver creates an instance of `SQLInput`, populating it with the attributes of the UDT. The driver then passes the input stream to the method `SQLData.readSQL`, which in turn calls the `SQLInput` reader methods in its implementation for reading the attributes from the input stream.

## Summary

| ### Public methods ||
|---|---|
| ` abstract https://developer.android.com/reference/java/sql/Array` | ` https://developer.android.com/reference/java/sql/SQLInput#readArray()() ` Reads an SQL `ARRAY` value from the stream and returns it as an `Array` object in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/io/InputStream` | ` https://developer.android.com/reference/java/sql/SQLInput#readAsciiStream()() ` Reads the next attribute in the stream and returns it as a stream of ASCII characters. |
| ` abstract https://developer.android.com/reference/java/math/BigDecimal` | ` https://developer.android.com/reference/java/sql/SQLInput#readBigDecimal()() ` Reads the next attribute in the stream and returns it as a `java.math.BigDecimal` object in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/io/InputStream` | ` https://developer.android.com/reference/java/sql/SQLInput#readBinaryStream()() ` Reads the next attribute in the stream and returns it as a stream of uninterpreted bytes. |
| ` abstract https://developer.android.com/reference/java/sql/Blob` | ` https://developer.android.com/reference/java/sql/SQLInput#readBlob()() ` Reads an SQL `BLOB` value from the stream and returns it as a `Blob` object in the Java programming language. |
| ` abstract boolean` | ` https://developer.android.com/reference/java/sql/SQLInput#readBoolean()() ` Reads the next attribute in the stream and returns it as a `boolean` in the Java programming language. |
| ` abstract byte` | ` https://developer.android.com/reference/java/sql/SQLInput#readByte()() ` Reads the next attribute in the stream and returns it as a `byte` in the Java programming language. |
| ` abstract byte[]` | ` https://developer.android.com/reference/java/sql/SQLInput#readBytes()() ` Reads the next attribute in the stream and returns it as an array of bytes in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/io/Reader` | ` https://developer.android.com/reference/java/sql/SQLInput#readCharacterStream()() ` Reads the next attribute in the stream and returns it as a stream of Unicode characters. |
| ` abstract https://developer.android.com/reference/java/sql/Clob` | ` https://developer.android.com/reference/java/sql/SQLInput#readClob()() ` Reads an SQL `CLOB` value from the stream and returns it as a `Clob` object in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/sql/Date` | ` https://developer.android.com/reference/java/sql/SQLInput#readDate()() ` Reads the next attribute in the stream and returns it as a `java.sql.Date` object. |
| ` abstract double` | ` https://developer.android.com/reference/java/sql/SQLInput#readDouble()() ` Reads the next attribute in the stream and returns it as a `double` in the Java programming language. |
| ` abstract float` | ` https://developer.android.com/reference/java/sql/SQLInput#readFloat()() ` Reads the next attribute in the stream and returns it as a `float` in the Java programming language. |
| ` abstract int` | ` https://developer.android.com/reference/java/sql/SQLInput#readInt()() ` Reads the next attribute in the stream and returns it as an `int` in the Java programming language. |
| ` abstract long` | ` https://developer.android.com/reference/java/sql/SQLInput#readLong()() ` Reads the next attribute in the stream and returns it as a `long` in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/sql/NClob` | ` https://developer.android.com/reference/java/sql/SQLInput#readNClob()() ` Reads an SQL `NCLOB` value from the stream and returns it as a `NClob` object in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/sql/SQLInput#readNString()() ` Reads the next attribute in the stream and returns it as a `String` in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/sql/SQLInput#readObject()() ` Reads the datum at the head of the stream and returns it as an `Object` in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/sql/Ref` | ` https://developer.android.com/reference/java/sql/SQLInput#readRef()() ` Reads an SQL `REF` value from the stream and returns it as a `Ref` object in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/sql/RowId` | ` https://developer.android.com/reference/java/sql/SQLInput#readRowId()() ` Reads an SQL `ROWID` value from the stream and returns it as a `RowId` object in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/sql/SQLXML` | ` https://developer.android.com/reference/java/sql/SQLInput#readSQLXML()() ` Reads an SQL `XML` value from the stream and returns it as a `SQLXML` object in the Java programming language. |
| ` abstract short` | ` https://developer.android.com/reference/java/sql/SQLInput#readShort()() ` Reads the next attribute in the stream and returns it as a `short` in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/sql/SQLInput#readString()() ` Reads the next attribute in the stream and returns it as a `String` in the Java programming language. |
| ` abstract https://developer.android.com/reference/java/sql/Time` | ` https://developer.android.com/reference/java/sql/SQLInput#readTime()() ` Reads the next attribute in the stream and returns it as a `java.sql.Time` object. |
| ` abstract https://developer.android.com/reference/java/sql/Timestamp` | ` https://developer.android.com/reference/java/sql/SQLInput#readTimestamp()() ` Reads the next attribute in the stream and returns it as a `java.sql.Timestamp` object. |
| ` abstract https://developer.android.com/reference/java/net/URL` | ` https://developer.android.com/reference/java/sql/SQLInput#readURL()() ` Reads an SQL `DATALINK` value from the stream and returns it as a `java.net.URL` object in the Java programming language. |
| ` abstract boolean` | ` https://developer.android.com/reference/java/sql/SQLInput#wasNull()() ` Retrieves whether the last value read was SQL `NULL`. |

## Public methods

### readArray

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

```
public abstract Array readArray ()
```

Reads an SQL `ARRAY` value from the stream and returns it as an `Array` object in the Java programming language.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/sql/Array` | an `Array` object representing data of the SQL `ARRAY` value at the head of the stream; `null` if the value read is SQL `NULL` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readAsciiStream

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

```
public abstract InputStream readAsciiStream ()
```

Reads the next attribute in the stream and returns it as a stream of ASCII characters.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/io/InputStream` | the attribute; if the value is SQL `NULL`, returns `null` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readBigDecimal

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

```
public abstract BigDecimal readBigDecimal ()
```

Reads the next attribute in the stream and returns it as a `java.math.BigDecimal` object in the Java programming language.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/math/BigDecimal` | the attribute; if the value is SQL `NULL`, returns `null` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readBinaryStream

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

```
public abstract InputStream readBinaryStream ()
```

Reads the next attribute in the stream and returns it as a stream of uninterpreted bytes.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/io/InputStream` | the attribute; if the value is SQL `NULL`, returns `null` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readBlob

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

```
public abstract Blob readBlob ()
```

Reads an SQL `BLOB` value from the stream and returns it as a `Blob` object in the Java programming language.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/sql/Blob` | a `Blob` object representing data of the SQL `BLOB` value at the head of the stream; `null` if the value read is SQL `NULL` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readBoolean

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

```
public abstract boolean readBoolean ()
```

Reads the next attribute in the stream and returns it as a `boolean` in the Java programming language.

<br />

| Returns ||
|---|---|
| `boolean` | the attribute; if the value is SQL `NULL`, returns `false` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readByte

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

```
public abstract byte readByte ()
```

Reads the next attribute in the stream and returns it as a `byte` in the Java programming language.

<br />

| Returns ||
|---|---|
| `byte` | the attribute; if the value is SQL `NULL`, returns `0` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readBytes

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

```
public abstract byte[] readBytes ()
```

Reads the next attribute in the stream and returns it as an array of bytes in the Java programming language.

<br />

| Returns ||
|---|---|
| `byte[]` | the attribute; if the value is SQL `NULL`, returns `null` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readCharacterStream

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

```
public abstract Reader readCharacterStream ()
```

Reads the next attribute in the stream and returns it as a stream of Unicode characters.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/io/Reader` | the attribute; if the value is SQL `NULL`, returns `null` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readClob

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

```
public abstract Clob readClob ()
```

Reads an SQL `CLOB` value from the stream and returns it as a `Clob` object in the Java programming language.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/sql/Clob` | a `Clob` object representing data of the SQL `CLOB` value at the head of the stream; `null` if the value read is SQL `NULL` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readDate

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

```
public abstract Date readDate ()
```

Reads the next attribute in the stream and returns it as a `java.sql.Date` object.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/sql/Date` | the attribute; if the value is SQL `NULL`, returns `null` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readDouble

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

```
public abstract double readDouble ()
```

Reads the next attribute in the stream and returns it as a `double` in the Java programming language.

<br />

| Returns ||
|---|---|
| `double` | the attribute; if the value is SQL `NULL`, returns `0` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readFloat

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

```
public abstract float readFloat ()
```

Reads the next attribute in the stream and returns it as a `float` in the Java programming language.

<br />

| Returns ||
|---|---|
| `float` | the attribute; if the value is SQL `NULL`, returns `0` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readInt

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

```
public abstract int readInt ()
```

Reads the next attribute in the stream and returns it as an `int` in the Java programming language.

<br />

| Returns ||
|---|---|
| `int` | the attribute; if the value is SQL `NULL`, returns `0` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readLong

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

```
public abstract long readLong ()
```

Reads the next attribute in the stream and returns it as a `long` in the Java programming language.

<br />

| Returns ||
|---|---|
| `long` | the attribute; if the value is SQL `NULL`, returns `0` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readNClob

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

```
public abstract NClob readNClob ()
```

Reads an SQL `NCLOB` value from the stream and returns it as a `NClob` object in the Java programming language.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/sql/NClob` | a `NClob` object representing data of the SQL `NCLOB` value at the head of the stream; `null` if the value read is SQL `NULL` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readNString

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

```
public abstract String readNString ()
```

Reads the next attribute in the stream and returns it as a `String` in the Java programming language. It is intended for use when accessing `NCHAR`,`NVARCHAR` and `LONGNVARCHAR` columns.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | the attribute; if the value is SQL `NULL`, returns `null` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readObject

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

```
public abstract Object readObject ()
```

Reads the datum at the head of the stream and returns it as an `Object` in the Java programming language. The actual type of the object returned is determined by the default type mapping, and any customizations present in this stream's type map.

A type map is registered with the stream by the JDBC driver before the stream is passed to the application.

When the datum at the head of the stream is an SQL `NULL`, the method returns `null`. If the datum is an SQL structured or distinct type, it determines the SQL type of the datum at the head of the stream. If the stream's type map has an entry for that SQL type, the driver constructs an object of the appropriate class and calls the method `SQLData.readSQL` on that object, which reads additional data from the stream, using the protocol described for that method.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/Object` | the datum at the head of the stream as an `Object` in the Java programming language;`null` if the datum is SQL `NULL` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readRef

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

```
public abstract Ref readRef ()
```

Reads an SQL `REF` value from the stream and returns it as a `Ref` object in the Java programming language.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/sql/Ref` | a `Ref` object representing the SQL `REF` value at the head of the stream; `null` if the value read is SQL `NULL` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readRowId

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

```
public abstract RowId readRowId ()
```

Reads an SQL `ROWID` value from the stream and returns it as a `RowId` object in the Java programming language.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/sql/RowId` | a `RowId` object representing data of the SQL `ROWID` value at the head of the stream; `null` if the value read is SQL `NULL` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readSQLXML

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

```
public abstract SQLXML readSQLXML ()
```

Reads an SQL `XML` value from the stream and returns it as a `SQLXML` object in the Java programming language.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLXML` | a `SQLXML` object representing data of the SQL `XML` value at the head of the stream; `null` if the value read is SQL `NULL` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readShort

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

```
public abstract short readShort ()
```

Reads the next attribute in the stream and returns it as a `short` in the Java programming language.

<br />

| Returns ||
|---|---|
| `short` | the attribute; if the value is SQL `NULL`, returns `0` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readString

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

```
public abstract String readString ()
```

Reads the next attribute in the stream and returns it as a `String` in the Java programming language.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | the attribute; if the value is SQL `NULL`, returns `null` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readTime

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

```
public abstract Time readTime ()
```

Reads the next attribute in the stream and returns it as a `java.sql.Time` object.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/sql/Time` | the attribute; if the value is SQL `NULL`, returns `null` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readTimestamp

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

```
public abstract Timestamp readTimestamp ()
```

Reads the next attribute in the stream and returns it as a `java.sql.Timestamp` object.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/sql/Timestamp` | the attribute; if the value is SQL `NULL`, returns `null` <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### readURL

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

```
public abstract URL readURL ()
```

Reads an SQL `DATALINK` value from the stream and returns it as a `java.net.URL` object in the Java programming language.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/net/URL` | a `java.net.URL` object. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs, or if a URL is malformed |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |

### wasNull

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

```
public abstract boolean wasNull ()
```

Retrieves whether the last value read was SQL `NULL`.

<br />

| Returns ||
|---|---|
| `boolean` | `true` if the most recently read SQL value was SQL `NULL`; `false` otherwise <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLException` | if a database access error occurs |
| `https://developer.android.com/reference/java/sql/SQLFeatureNotSupportedException` | if the JDBC driver does not support this method |