get

abstract fun get(vararg args: Any?): SQLiteObject?

Single Value

Execute the underlying statement against the owning SQLiteDatabase; then, build a single result, structured as a map-like SQLiteObject.

This method is optimized to never decode more than one result. The user's query is not modified, and may additionally be optimized by appending LIMIT 1.

If no results are found, null is returned; if the underlying database has closed, an error is thrown.

Repeated calls to this method with unchanging args will cache the underlying rendered query, but will not cache the result-set.

Return

Single matching SQLiteObject instance, or null.

Parameters

args

Arguments to render into the query; if a map is provided as the first and only argument, it is used as a suite of named arguments.