Most visited

Recently visited

Results for

Added in API level 1

MatrixCursor

public class MatrixCursor
extends AbstractCursor

java.lang.Object
↳	android.database.AbstractCursor
	↳	android.database.MatrixCursor

一个由Object的数组支持的可变游标实现。使用newRow()添加行。根据需要自动扩展内部容量。

Summary

Nested classes
`class`	`MatrixCursor.RowBuilder` 使用以下任一方法构建一行值：可以使用`add(Object)`以明确的列顺序添加值，该列从最左列开始并一次添加一列值。

Nested classes

class

MatrixCursor.RowBuilder

使用以下任一方法构建一行值：

可以使用add(Object)以明确的列顺序添加值，该列从最左列开始并一次添加一列值。

Inherited constants

From interface android.database.Cursor

Inherited fields

From class android.database.AbstractCursor

Public constructors
`MatrixCursor(String[] columnNames, int initialCapacity)` 用给定的初始容量构造一个新的游标。
`MatrixCursor(String[] columnNames)` 构造一个新的游标。

Public methods
`void`	`addRow(Object[] columnValues)` 用给定列值添加新行到最后。
`void`	`addRow(Iterable<?> columnValues)` 用给定列值添加新行到最后。
`byte[]`	`getBlob(int column)` 以字节数组的形式返回请求的列的值。
`String[]`	`getColumnNames()` 以结果中列出的顺序返回一个字符串数组，其中包含结果集中所有列的名称。
`int`	`getCount()` 返回游标中的行数。
`double`	`getDouble(int column)` 以double形式返回请求的列的值。
`float`	`getFloat(int column)` 以浮点形式返回请求的列的值。
`int`	`getInt(int column)` 以int形式返回请求的列的值。
`long`	`getLong(int column)` 以long形式返回请求列的值。
`short`	`getShort(int column)` 以短为单位返回请求列的值。
`String`	`getString(int column)` 以String形式返回请求的列的值。
`int`	`getType(int column)` 返回给定列值的数据类型。
`boolean`	`isNull(int column)` 如果指定列中的值为空，则返回 `true` 。
`MatrixCursor.RowBuilder`	`newRow()` 在最后添加一个新行并返回该行的构建器。

Inherited methods

From class android.database.AbstractCursor

`void`	`checkPosition()` 如果光标位置超出范围，则此函数将引发CursorIndexOutOfBoundsException。
`void`	`close()` 关闭光标，释放其所有资源并使其完全无效。
`void`	`copyStringToBuffer(int columnIndex, CharArrayBuffer buffer)` 检索请求的列文本并将其存储在提供的缓冲区中。
`void`	`deactivate()` 取消激活光标，使所有调用失败，直到调用 `requery()` 。
`void`	`fillWindow(int position, CursorWindow window)` 将光标数据复制到窗口中。
`void`	`finalize()` 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。
`byte[]`	`getBlob(int column)` 以字节数组的形式返回请求的列的值。
`int`	`getColumnCount()` 返回总列数
`int`	`getColumnIndex(String columnName)` 返回给定列名称的从零开始的索引，如果该列不存在，则返回-1。
`int`	`getColumnIndexOrThrow(String columnName)` 返回给定列名称的从零开始的索引，如果列不存在则返回 `IllegalArgumentException` 。
`String`	`getColumnName(int columnIndex)` 返回给定的从零开始的列索引处的列名称。
`abstract String[]`	`getColumnNames()` 以结果中列出的顺序返回一个字符串数组，其中包含结果集中所有列的名称。
`abstract int`	`getCount()` 返回游标中的行数。
`abstract double`	`getDouble(int column)` 以double形式返回请求的列的值。
`Bundle`	`getExtras()` 返回一组额外的值。
`abstract float`	`getFloat(int column)` 以浮点形式返回请求的列的值。
`abstract int`	`getInt(int column)` 以int形式返回请求的列的值。
`abstract long`	`getLong(int column)` 以long形式返回请求列的值。
`Uri`	`getNotificationUri()` 返回此游标数据中的更改通知将传递的URI，如先前由 `setNotificationUri(ContentResolver, Uri)`设置的 `setNotificationUri(ContentResolver, Uri)` 。
`final int`	`getPosition()` 返回行集合中光标的当前位置。
`abstract short`	`getShort(int column)` 以短为单位返回请求列的值。
`abstract String`	`getString(int column)` 以String形式返回请求的列的值。
`int`	`getType(int column)` 返回给定列值的数据类型。
`Object`	`getUpdatedField(int columnIndex)` 此方法在API级别11中已被弃用。始终返回null，因为游标不支持更新行
`boolean`	`getWantsAllOnMoveCalls()` 如果此方法返回true，onMove（）将仅在进程间调用。
`CursorWindow`	`getWindow()` 如果光标由 `CursorWindow`支持，则返回一个预填充的窗口，其中包含游标的内容，否则返回null。
`final boolean`	`isAfterLast()` 返回指针是否指向最后一行之后的位置。
`final boolean`	`isBeforeFirst()` 返回光标是否指向第一行之前的位置。
`boolean`	`isClosed()` 如果光标关闭，则返回true
`boolean`	`isFieldUpdated(int columnIndex)` 此方法在API级别11中已弃用。由于游标不支持更新行，因此始终返回false
`final boolean`	`isFirst()` 返回光标是否指向第一行。
`final boolean`	`isLast()` 返回指针是否指向最后一行。
`abstract boolean`	`isNull(int column)` 如果指定列中的值为空，则返回 `true` 。
`final boolean`	`move(int offset)` 从当前位置向前或向后移动光标相对量。
`final boolean`	`moveToFirst()` 将光标移到第一行。
`final boolean`	`moveToLast()` 将光标移到最后一行。
`final boolean`	`moveToNext()` 将光标移到下一行。
`final boolean`	`moveToPosition(int position)` 将光标移到绝对位置。
`final boolean`	`moveToPrevious()` 将光标移到上一行。
`void`	`onChange(boolean selfChange)` 子类在完成提交更新以通知所有观察者时必须调用此方法。
`boolean`	`onMove(int oldPosition, int newPosition)` 每次将光标成功滚动到新位置时都会调用此函数，从而使子类有机会更新其可能具有的任何状态。
`void`	`registerContentObserver(ContentObserver observer)` 注册一个观察者，当支持该游标的内容发生更改时调用该观察者。
`void`	`registerDataSetObserver(DataSetObserver observer)` 注册时的变化发生在该光标数据集的内容被称为，例如一个观察者，当数据集通过改变 `requery()` ， `deactivate()` ，或 `close()` 。
`boolean`	`requery()` 执行再次创建光标的查询，刷新其内容。
`Bundle`	`respond(Bundle extras)` 这是光标与光标通信的用户的一种带外方式。
`void`	`setExtras(Bundle extras)` 设置 `Bundle`返回的 `getExtras()` 。
`void`	`setNotificationUri(ContentResolver cr, Uri notifyUri)` 指定要监视更改的内容URI。
`void`	`unregisterContentObserver(ContentObserver observer)` 通过 `registerContentObserver(ContentObserver)`取消注册先前使用此光标注册的观察者。
`void`	`unregisterDataSetObserver(DataSetObserver observer)` 通过 `registerContentObserver(ContentObserver)`取消注册先前已通过此游标注册的观察者。

From class java.lang.Object

From interface android.database.CrossProcessCursor

From interface android.database.Cursor

`abstract void`	`close()` 关闭光标，释放其所有资源并使其完全无效。
`abstract void`	`copyStringToBuffer(int columnIndex, CharArrayBuffer buffer)` 检索请求的列文本并将其存储在提供的缓冲区中。
`abstract void`	`deactivate()` 此方法在API级别16中已弃用。由于`requery()`已弃用，因此也是如此。
`abstract byte[]`	`getBlob(int columnIndex)` 以字节数组的形式返回请求的列的值。
`abstract int`	`getColumnCount()` 返回总列数
`abstract int`	`getColumnIndex(String columnName)` 返回给定列名称的从零开始的索引，如果该列不存在，则返回-1。
`abstract int`	`getColumnIndexOrThrow(String columnName)` 返回给定列名称的从零开始的索引，如果该列不存在则返回 `IllegalArgumentException` 。
`abstract String`	`getColumnName(int columnIndex)` 返回给定的从零开始的列索引处的列名称。
`abstract String[]`	`getColumnNames()` 以结果中列出的顺序返回一个字符串数组，其中包含结果集中所有列的名称。
`abstract int`	`getCount()` 返回游标中的行数。
`abstract double`	`getDouble(int columnIndex)` 以double形式返回请求的列的值。
`abstract Bundle`	`getExtras()` 返回一组额外的值。
`abstract float`	`getFloat(int columnIndex)` 以浮点形式返回请求的列的值。
`abstract int`	`getInt(int columnIndex)` 以int形式返回请求的列的值。
`abstract long`	`getLong(int columnIndex)` 以long形式返回请求列的值。
`abstract Uri`	`getNotificationUri()` 返回此游标数据中的更改通知将传递的URI，如先前由 `setNotificationUri(ContentResolver, Uri)`设置的 `setNotificationUri(ContentResolver, Uri)` 。
`abstract int`	`getPosition()` 返回行集合中光标的当前位置。
`abstract short`	`getShort(int columnIndex)` 以短为单位返回请求列的值。
`abstract String`	`getString(int columnIndex)` 以String形式返回请求的列的值。
`abstract int`	`getType(int columnIndex)` 返回给定列值的数据类型。
`abstract boolean`	`getWantsAllOnMoveCalls()` 如果此方法返回true，onMove（）将仅在进程间调用。
`abstract boolean`	`isAfterLast()` 返回指针是否指向最后一行之后的位置。
`abstract boolean`	`isBeforeFirst()` 返回光标是否指向第一行之前的位置。
`abstract boolean`	`isClosed()` 如果光标关闭，则返回true
`abstract boolean`	`isFirst()` 返回光标是否指向第一行。
`abstract boolean`	`isLast()` 返回指针是否指向最后一行。
`abstract boolean`	`isNull(int columnIndex)` 如果指定列中的值为空，则返回 `true` 。
`abstract boolean`	`move(int offset)` 从当前位置向前或向后移动光标相对量。
`abstract boolean`	`moveToFirst()` 将光标移到第一行。
`abstract boolean`	`moveToLast()` 将光标移到最后一行。
`abstract boolean`	`moveToNext()` 将光标移到下一行。
`abstract boolean`	`moveToPosition(int position)` 将光标移到绝对位置。
`abstract boolean`	`moveToPrevious()` 将光标移到上一行。
`abstract void`	`registerContentObserver(ContentObserver observer)` 注册一个观察者，当支持该游标的内容发生更改时调用该观察者。
`abstract void`	`registerDataSetObserver(DataSetObserver observer)` 注册时的变化发生在该光标数据集的内容被称为，例如一个观察者，当数据集通过改变 `requery()` ， `deactivate()` ，或 `close()` 。
`abstract boolean`	`requery()` 此方法在API级别11中已弃用。请勿使用此方法。只需要请求一个新的游标，以便您可以异步执行此操作，并在新游标返回时更新您的列表视图。
`abstract Bundle`	`respond(Bundle extras)` 这是光标与光标通信的用户的一种带外方式。
`abstract void`	`setExtras(Bundle extras)` 设置 `Bundle`返回的 `getExtras()` 。
`abstract void`	`setNotificationUri(ContentResolver cr, Uri uri)` 注册以观看更改的内容URI。
`abstract void`	`unregisterContentObserver(ContentObserver observer)` 通过 `registerContentObserver(ContentObserver)`取消注册先前已通过此光标注册的观察者。
`abstract void`	`unregisterDataSetObserver(DataSetObserver observer)` 通过 `registerContentObserver(ContentObserver)`取消注册先前已使用此光标注册的观察者。

From interface java.io.Closeable

From interface java.lang.AutoCloseable

Public constructors

MatrixCursor

Added in API level 1

MatrixCursor (String[] columnNames, 
                int initialCapacity)

用给定的初始容量构造一个新的游标。

Parameters
`columnNames`	`String`: names of the columns, the ordering of which determines column ordering elsewhere in this cursor
`initialCapacity`	`int`: in rows

MatrixCursor

Added in API level 1

MatrixCursor (String[] columnNames)

构造一个新的游标。

Parameters
`columnNames`	`String`: names of the columns, the ordering of which determines column ordering elsewhere in this cursor

Public methods

addRow

Added in API level 1

void addRow (Object[] columnValues)

用给定列值添加新行到最后。并行使用不安全。

Parameters
`columnValues`	`Object`: in the same order as the the column names specified at cursor construction time

Throws
`IllegalArgumentException`	if `columnValues.length != columnNames.length`

addRow

Added in API level 1

void addRow (Iterable<?> columnValues)

用给定列值添加新行到最后。并行使用不安全。

Parameters
`columnValues`	`Iterable`: in the same order as the the column names specified at cursor construction time

Throws
`IllegalArgumentException`	if `columnValues.size() != columnNames.length`

getBlob

Added in API level 1

byte[] getBlob (int column)

以字节数组的形式返回请求的列的值。

结果以及当列值为空或列类型不是blob类型时此方法是否引发异常是实现定义的。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`byte[]`	the value of that column as a byte array.

getColumnNames

Added in API level 1

String[] getColumnNames ()

以结果中列出的顺序返回一个字符串数组，其中包含结果集中所有列的名称。

Returns
`String[]`	the names of the columns returned in this query.

getCount

Added in API level 1

int getCount ()

返回游标中的行数。

Returns
`int`	the number of rows in the cursor.

getDouble

Added in API level 1

double getDouble (int column)

以double形式返回请求的列的值。

结果以及在列值为空，列类型不是浮点类型或浮点值不可表示时该方法抛出异常，或者由于实现定义了 double值，因此浮点值不可表示。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`double`	the value of that column as a double.

getFloat

Added in API level 1

float getFloat (int column)

以浮点形式返回请求的列的值。

结果以及此方法在列值为空，列类型不是浮点类型或浮点值不可表示时引发异常，或者浮点值不可表示，因为 float值是实现定义的。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`float`	the value of that column as a float.

getInt

Added in API level 1

int getInt (int column)

以int形式返回请求的列的值。

结果，这种方法是否抛出异常当列值为空，列类型是不是一个整数类型，或者整数值是范围[外 Integer.MIN_VALUE ， Integer.MAX_VALUE ]为实现定义的。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`int`	the value of that column as an int.

getLong

Added in API level 1

long getLong (int column)

以long形式返回请求列的值。

结果，这种方法是否抛出异常当列值为空，列类型是不是一个整数类型，或者整数值是范围[外 Long.MIN_VALUE ， Long.MAX_VALUE ]为实现定义的。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`long`	the value of that column as a long.

getShort

Added in API level 1

short getShort (int column)

以短为单位返回请求列的值。

结果，这种方法是否抛出异常当列值为空，列类型是不是一个整数类型，或者整数值是范围[外 Short.MIN_VALUE ， Short.MAX_VALUE ]为实现定义的。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`short`	the value of that column as a short.

getString

Added in API level 1

String getString (int column)

以String形式返回请求的列的值。

结果以及此方法在列值为空或列类型不是字符串类型时是否引发异常是实现定义的。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`String`	the value of that column as a String.

getType

Added in API level 11

int getType (int column)

返回给定列值的数据类型。列的优选类型的返回，但如在get型方法如中记录的数据可以被转换到其它类型的getInt(int) ， getFloat(int)等

返回的列类型是

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`int`	column value type

isNull

Added in API level 1

boolean isNull (int column)

如果指定列中的值为空，则返回 true 。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`boolean`	whether the column value is null.

newRow

Added in API level 1

MatrixCursor.RowBuilder newRow ()

在最后添加一个新行并返回该行的构建器。并行使用不安全。

Returns
`MatrixCursor.RowBuilder`	builder which can be used to set the column values for the new row

Interfaces

Classes

Enums

Exceptions

Most visited

Recently visited

Results for

MatrixCursor

Summary

Nested classes

Inherited constants

Inherited fields

Public constructors

Public methods

Inherited methods

Public constructors

MatrixCursor

MatrixCursor

Public methods

addRow

addRow

getBlob

getColumnNames

getCount

getDouble

getFloat

getInt

getLong

getShort

getString

getType

isNull

newRow