CursorWindow

CREATOR

Creator<CursorWindow> CREATOR

CursorWindow

CursorWindow (String name)

创建一个新的空游标窗口并给它一个名字。

游标最初没有行或列。 在向光标添加任何行之前，请调用setNumColumns(int)以设置列数。

CursorWindow

CursorWindow (boolean localWindow)

此构造函数在API级别15中已被弃用。
本地和远程光标窗口之间不再有区别。 改为使用CursorWindow(String)构造函数。

创建一个新的空白光标窗口。

游标最初没有行或列。 在向光标添加任何行之前调用setNumColumns(int)以设置列数。

allocRow

boolean allocRow ()

在此光标窗口的末尾分配一个新行。

clear

void clear ()

清除窗口的现有内容，使其可以安全地重新用于新数据。

开始位置（ getStartPosition() ），行数（ getNumRows() ）以及游标中的列数都被重置为零。

copyStringToBuffer

void copyStringToBuffer (int row, 
                int column, 
                CharArrayBuffer buffer)

将指定的行和列索引中的字段文本复制到 CharArrayBuffer 。

缓冲区填充如下：

• If the buffer is too small for the value to be copied, then it is automatically resized.
• If the field is of type FIELD_TYPE_NULL, then the buffer is set to an empty string.
• If the field is of type FIELD_TYPE_STRING, then the buffer is set to the contents of the string.
• If the field is of type FIELD_TYPE_INTEGER, then the buffer is set to a string representation of the integer in decimal, obtained by formatting the value with the printf family of functions using format specifier %lld.
• If the field is of type FIELD_TYPE_FLOAT, then the buffer is set to a string representation of the floating-point value in decimal, obtained by formatting the value with the printf family of functions using format specifier %g.
• If the field is of type FIELD_TYPE_BLOB, then a SQLiteException is thrown.

describeContents

int describeContents ()

描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如，如果对象将在writeToParcel(Parcel, int)的输出中包含writeToParcel(Parcel, int) ，则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR位。

freeLastRow

void freeLastRow ()

释放此光标窗口中的最后一行。

getBlob

byte[] getBlob (int row, 
                int column)

获取指定行和列索引处字段的值作为字节数组。

结果如下确定：

• If the field is of type FIELD_TYPE_NULL, then the result is null.
• If the field is of type FIELD_TYPE_BLOB, then the result is the blob value.
• If the field is of type FIELD_TYPE_STRING, then the result is the array of bytes that make up the internal representation of the string value.
• If the field is of type FIELD_TYPE_INTEGER or FIELD_TYPE_FLOAT, then a SQLiteException is thrown.

getDouble

double getDouble (int row, 
                int column)

获取指定行和列索引处字段的值，作为 double 。

结果如下确定：

• If the field is of type FIELD_TYPE_NULL, then the result is 0.0.
• If the field is of type FIELD_TYPE_STRING, then the result is the value obtained by parsing the string value with strtod.
• If the field is of type FIELD_TYPE_INTEGER, then the result is the integer value converted to a double.
• If the field is of type FIELD_TYPE_FLOAT, then the result is the double value.
• If the field is of type FIELD_TYPE_BLOB, then a SQLiteException is thrown.

getFloat

float getFloat (int row, 
                int column)

获取指定行和列索引处的字段值，其值为 float 。

通过调用 getDouble(int, int)并将结果转换为 float来确定结果。

getInt

int getInt (int row, 
                int column)

获取指定行和列索引处的字段值，其值为 int 。

通过调用 getLong(int, int)并将结果转换为 int来确定结果。

getLong

long getLong (int row, 
                int column)

获取指定行和列索引处的字段值，其值为 long 。

结果如下确定：

• If the field is of type FIELD_TYPE_NULL, then the result is 0L.
• If the field is of type FIELD_TYPE_STRING, then the result is the value obtained by parsing the string value with strtoll.
• If the field is of type FIELD_TYPE_INTEGER, then the result is the long value.
• If the field is of type FIELD_TYPE_FLOAT, then the result is the floating-point value converted to a long.
• If the field is of type FIELD_TYPE_BLOB, then a SQLiteException is thrown.

getNumRows

int getNumRows ()

获取此窗口中的行数。

getShort

short getShort (int row, 
                int column)

获取指定行和列索引处的字段值，其值为 short 。

通过调用 getLong(int, int)并将结果转换为 short来确定结果。

getStartPosition

int getStartPosition ()

获取此光标窗口的起始位置。

起始位置是此窗口包含的第一行相对于 Cursor的整个结果集的 Cursor 。

getString

String getString (int row, 
                int column)

以字符串形式获取指定行和列索引处字段的值。

结果如下确定：

• If the field is of type FIELD_TYPE_NULL, then the result is null.
• If the field is of type FIELD_TYPE_STRING, then the result is the string value.
• If the field is of type FIELD_TYPE_INTEGER, then the result is a string representation of the integer in decimal, obtained by formatting the value with the printf family of functions using format specifier %lld.
• If the field is of type FIELD_TYPE_FLOAT, then the result is a string representation of the floating-point value in decimal, obtained by formatting the value with the printf family of functions using format specifier %g.
• If the field is of type FIELD_TYPE_BLOB, then a SQLiteException is thrown.

getType

int getType (int row, 
                int column)

返回指定行和列索引处字段的类型。

返回的字段类型是：

• FIELD_TYPE_NULL
• FIELD_TYPE_INTEGER
• FIELD_TYPE_FLOAT
• FIELD_TYPE_STRING
• FIELD_TYPE_BLOB

isBlob

boolean isBlob (int row, 
                int column)

此方法在API级别11中已弃用。
改为使用getType(int, int) 。

如果指定行和列索引处的字段的类型为 FIELD_TYPE_BLOB或 FIELD_TYPE_NULL则返回true。

isFloat

boolean isFloat (int row, 
                int column)

此方法在API级别11中已弃用。
改为使用getType(int, int) 。

如果指定的行和列索引处的字段的类型为 FIELD_TYPE_FLOAT ，则返回true。

isLong

boolean isLong (int row, 
                int column)

此方法在API级别11中已弃用。
改为使用getType(int, int) 。

如果指定的行和列索引处的字段的类型为 FIELD_TYPE_INTEGER ，则返回true。

isNull

boolean isNull (int row, 
                int column)

此方法在API级别11中已弃用。
改为使用getType(int, int) 。

如果指定行和列索引处的字段的类型为 FIELD_TYPE_NULL ，则返回true。

isString

boolean isString (int row, 
                int column)

此方法在API级别11中已弃用。
改为使用getType(int, int) 。

如果指定的行和列索引处的字段的类型为 FIELD_TYPE_STRING或 FIELD_TYPE_NULL则返回true。

newFromParcel

CursorWindow newFromParcel (Parcel p)

putBlob

boolean putBlob (byte[] value, 
                int row, 
                int column)

将字节数组复制到指定行和列索引处的字段中。

putDouble

boolean putDouble (double value, 
                int row, 
                int column)

将双精度浮点值放入指定行和列索引处的字段中。

putLong

boolean putLong (long value, 
                int row, 
                int column)

在指定的行和列索引处将长整数放入字段中。

putNull

boolean putNull (int row, 
                int column)

将空值放入指定行和列索引处的字段中。

putString

boolean putString (String value, 
                int row, 
                int column)

将字符串复制到指定行和列索引处的字段中。

setNumColumns

boolean setNumColumns (int columnNum)

设置此窗口中的列数。

必须在将任何行添加到窗口之前调用此方法，否则如果列数与当前列数不同，则将无法设置列数。

setStartPosition

void setStartPosition (int pos)

设置此光标窗口的起始位置。

起始位置是该窗口包含的第一行相对于 Cursor的整个结果集的 Cursor 。

toString

String toString ()

返回对象的字符串表示形式。 通常， toString方法会返回一个“文本地表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述，对于一个人来说很容易阅读。 建议所有子类重写此方法。

类Object的toString方法返回一个字符串，其中包含对象为实例的类的名称，符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说，这个方法返回一个字符串，其值等于：

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

writeToParcel

void writeToParcel (Parcel dest, 
                int flags)

将此对象平铺到一个包裹中。

finalize

void finalize ()

当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 子类会覆盖finalize方法以处置系统资源或执行其他清理。

的常规协定finalize是，它被调用，如果当在Java ^TM虚拟机已确定不再有由该目的可以通过还没有死亡，除了作为一个动作的结果的任何线程访问的任何手段取决于某些其他可以完成的对象或类别的最终定稿。 finalize方法可以采取任何行动，包括使该对象再次可用于其他线程; 然而， finalize的通常目的是在对象被不可撤销地丢弃之前执行清理操作。 例如，表示输入/输出连接的对象的finalize方法可能会执行显式I / O事务，以在永久丢弃该对象之前中断连接。

类Object的finalize方法Object执行特殊操作; 它只是正常返回。 Object子类可能会覆盖此定义。

Java编程语言不保证哪个线程将为任何给定的对象调用finalize方法。 但是，保证调用finalize的线程在调用finalize时不会保留任何用户可见的同步锁。 如果finalize方法引发未捕获的异常，则忽略该异常，并终止该对象的终止。

在针对某个对象调用了 finalize方法之后，在Java虚拟机再次确定不再有任何方法可以通过尚未死亡的任何线程访问此对象，包括可能的操作通过准备完成的其他对象或类别，此时该对象可能被丢弃。

对于任何给定的对象，Java虚拟机永远不会多次调用 finalize方法。

由 finalize方法引发的任何异常 finalize导致终止此对象的终止，但会被忽略。

onAllReferencesReleased

void onAllReferencesReleased ()

当通过调用 releaseReference()或 close()释放对象的最后一个引用时调用。