android.database

Class MatrixCursor.RowBuilder

java.lang.Object

android.database.MatrixCursor.RowBuilder

Enclosing class:

MatrixCursor

public class MatrixCursor.RowBuilder
extends Object

Builds a row of values using either of these approaches:

• Values can be added with explicit column ordering using add(Object), which starts from the left-most column and adds one column value at a time. This follows the same ordering as the column names specified at cursor construction time.
• Column and value pairs can be offered for possible inclusion using add(String, Object). If the cursor includes the given column, the value will be set for that column, otherwise the value is ignored. This approach is useful when matching data to a custom projection.

Undefined values are left as null.

Method Summary

Modifier and Type	Method and Description
MatrixCursor.RowBuilder	add(Object columnValue) Sets the next column value in this row.
MatrixCursor.RowBuilder	add(String columnName, Object value) Offer value for possible inclusion if this cursor defines the given column.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

add

public MatrixCursor.RowBuilder add(Object columnValue)

Sets the next column value in this row.

Returns:

this builder to support chaining

Throws:

CursorIndexOutOfBoundsException - if you try to add too many values

add

public MatrixCursor.RowBuilder add(String columnName,
                                   Object value)

Offer value for possible inclusion if this cursor defines the given column. Columns not defined by the cursor are silently ignored.

Returns:

this builder to support chaining