public final class ContentValues
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.content.ContentValues |
该类用于存储 ContentResolver
可以处理的一组值。
Constants |
|
---|---|
String |
TAG |
Inherited constants |
---|
From interface android.os.Parcelable
|
Fields |
|
---|---|
public static final Creator<ContentValues> |
CREATOR |
Public constructors |
|
---|---|
ContentValues() 使用默认初始大小创建一组空的值 |
|
ContentValues(int size) 使用给定的初始大小创建一组空值 |
|
ContentValues(ContentValues from) 创建从给定集合复制的一组值 |
Public methods |
|
---|---|
void |
clear() 删除所有值。 |
boolean |
containsKey(String key) 如果此对象具有指定的值,则返回true。 |
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
boolean |
equals(Object object) 指示其他某个对象是否“等于”这一个。 |
Object |
get(String key) 获取一个值。 |
Boolean |
getAsBoolean(String key) 获取一个值并将其转换为布尔值。 |
Byte |
getAsByte(String key) 获取一个值并将其转换为一个字节。 |
byte[] |
getAsByteArray(String key) 获取一个字节数组的值。 |
Double |
getAsDouble(String key) 获取一个值并将其转换为Double。 |
Float |
getAsFloat(String key) 获取一个值并将其转换为一个Float。 |
Integer |
getAsInteger(String key) 获取一个值并将其转换为一个Integer。 |
Long |
getAsLong(String key) 获取一个值并将其转换为Long。 |
Short |
getAsShort(String key) 获取一个值并将其转换为Short。 |
String |
getAsString(String key) 获取一个值并将其转换为一个String。 |
int |
hashCode() 返回对象的哈希码值。 |
Set<String> |
keySet() 返回一组所有的键 |
void |
put(String key, Short value) 为该集合添加一个值。 |
void |
put(String key, Long value) 为该集合添加一个值。 |
void |
put(String key, Double value) 为该集合添加一个值。 |
void |
put(String key, Integer value) 为该集合添加一个值。 |
void |
put(String key, String value) 为该集合添加一个值。 |
void |
put(String key, Boolean value) 为该集合添加一个值。 |
void |
put(String key, Float value) 为该集合添加一个值。 |
void |
put(String key, byte[] value) 为该集合添加一个值。 |
void |
put(String key, Byte value) 为该集合添加一个值。 |
void |
putAll(ContentValues other) 从传入的ContentValues中添加所有值。 |
void |
putNull(String key) 向该集合添加一个空值。 |
void |
remove(String key) 删除一个值。 |
int |
size() 返回值的数量。 |
String |
toString() 返回一个字符串,其中包含此对象的简明易懂的描述。 |
Set<Entry<String, Object>> |
valueSet() 返回一组所有的键和值 |
void |
writeToParcel(Parcel parcel, int flags) 将此对象平铺到一个包裹中。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
ContentValues (int size)
使用给定的初始大小创建一组空值
Parameters | |
---|---|
size |
int : the initial size of the set of values |
ContentValues (ContentValues from)
创建从给定集合复制的一组值
Parameters | |
---|---|
from |
ContentValues : the values to copy |
boolean containsKey (String key)
如果此对象具有指定的值,则返回true。
Parameters | |
---|---|
key |
String : the value to check for |
Returns | |
---|---|
boolean |
true if the value is present, false otherwise |
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)
的输出中包含writeToParcel(Parcel, int)
,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR
位。
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
boolean equals (Object object)
指示其他某个对象是否“等于”这一个。
equals
方法在非空对象引用上实现等价关系:
x
, x.equals(x)
should return true
. x
and y
, x.equals(y)
should return true
if and only if y.equals(x)
returns true
. x
, y
, and z
, if x.equals(y)
returns true
and y.equals(z)
returns true
, then x.equals(z)
should return true
. x
and y
, multiple invocations of x.equals(y)
consistently return true
or consistently return false
, provided no information used in equals
comparisons on the objects is modified. x
, x.equals(null)
should return false
. 类Object
的equals
方法实现了对象上最可能的等价关系; 也就是说,对于任何非空参考值x
和y
,当且仅当x
和y
指向同一对象( x == y
的值为true
)时,此方法返回true
。
请注意,无论何时重写此方法,通常都必须重写 hashCode
方法,以便维护 hashCode
方法的一般合同,该方法声明等同对象必须具有相同的哈希代码。
Parameters | |
---|---|
object |
Object : the reference object with which to compare. |
Returns | |
---|---|
boolean |
true if this object is the same as the obj argument; false otherwise. |
Object get (String key)
获取一个值。 有效的值类型String
, Boolean
, Number
,并byte[]
实现。
Parameters | |
---|---|
key |
String : the value to get |
Returns | |
---|---|
Object |
the data for the value, or null if the value is missing or if null was previously added with the given key |
Boolean getAsBoolean (String key)
获取一个值并将其转换为布尔值。
Parameters | |
---|---|
key |
String : the value to get |
Returns | |
---|---|
Boolean |
the Boolean value, or null if the value is missing or cannot be converted |
Byte getAsByte (String key)
获取一个值并将其转换为一个字节。
Parameters | |
---|---|
key |
String : the value to get |
Returns | |
---|---|
Byte |
the Byte value, or null if the value is missing or cannot be converted |
byte[] getAsByteArray (String key)
获取一个字节数组的值。 请注意,此方法不会将任何其他类型转换为字节数组。
Parameters | |
---|---|
key |
String : the value to get |
Returns | |
---|---|
byte[] |
the byte[] value, or null is the value is missing or not a byte[] |
Double getAsDouble (String key)
获取一个值并将其转换为Double。
Parameters | |
---|---|
key |
String : the value to get |
Returns | |
---|---|
Double |
the Double value, or null if the value is missing or cannot be converted |
Float getAsFloat (String key)
获取一个值并将其转换为一个Float。
Parameters | |
---|---|
key |
String : the value to get |
Returns | |
---|---|
Float |
the Float value, or null if the value is missing or cannot be converted |
Integer getAsInteger (String key)
获取一个值并将其转换为一个Integer。
Parameters | |
---|---|
key |
String : the value to get |
Returns | |
---|---|
Integer |
the Integer value, or null if the value is missing or cannot be converted |
Long getAsLong (String key)
获取一个值并将其转换为Long。
Parameters | |
---|---|
key |
String : the value to get |
Returns | |
---|---|
Long |
the Long value, or null if the value is missing or cannot be converted |
Short getAsShort (String key)
获取一个值并将其转换为Short。
Parameters | |
---|---|
key |
String : the value to get |
Returns | |
---|---|
Short |
the Short value, or null if the value is missing or cannot be converted |
String getAsString (String key)
获取一个值并将其转换为一个String。
Parameters | |
---|---|
key |
String : the value to get |
Returns | |
---|---|
String |
the String for the value |
int hashCode ()
返回对象的哈希码值。 这种方法支持散列表的好处,例如HashMap
提供的HashMap
。
hashCode
的总合同是:
hashCode
method must consistently return the same integer, provided no information used in equals
comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. equals(Object)
method, then calling the hashCode
method on each of the two objects must produce the same integer result. equals(java.lang.Object)
method, then calling the hashCode
method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. 尽可能合理实用,由类Object
定义的hashCode方法确实为不同的对象返回不同的整数。 (这通常通过将对象的内部地址转换为整数来实现,但Java TM编程语言不需要此实现技术。)
Returns | |
---|---|
int |
a hash code value for this object. |
Set<String> keySet ()
返回一组所有的键
Returns | |
---|---|
Set<String> |
a set of all of the keys |
void put (String key, Short value)
为该集合添加一个值。
Parameters | |
---|---|
key |
String : the name of the value to put |
value |
Short : the data for the value to put |
void put (String key, Long value)
为该集合添加一个值。
Parameters | |
---|---|
key |
String : the name of the value to put |
value |
Long : the data for the value to put |
void put (String key, Double value)
为该集合添加一个值。
Parameters | |
---|---|
key |
String : the name of the value to put |
value |
Double : the data for the value to put |
void put (String key, Integer value)
为该集合添加一个值。
Parameters | |
---|---|
key |
String : the name of the value to put |
value |
Integer : the data for the value to put |
void put (String key, String value)
为该集合添加一个值。
Parameters | |
---|---|
key |
String : the name of the value to put |
value |
String : the data for the value to put |
void put (String key, Boolean value)
为该集合添加一个值。
Parameters | |
---|---|
key |
String : the name of the value to put |
value |
Boolean : the data for the value to put |
void put (String key, Float value)
为该集合添加一个值。
Parameters | |
---|---|
key |
String : the name of the value to put |
value |
Float : the data for the value to put |
void put (String key, byte[] value)
为该集合添加一个值。
Parameters | |
---|---|
key |
String : the name of the value to put |
value |
byte : the data for the value to put |
void put (String key, Byte value)
为该集合添加一个值。
Parameters | |
---|---|
key |
String : the name of the value to put |
value |
Byte : the data for the value to put |
void putAll (ContentValues other)
从传入的ContentValues中添加所有值。
Parameters | |
---|---|
other |
ContentValues : the ContentValues from which to copy |
void putNull (String key)
向该集合添加一个空值。
Parameters | |
---|---|
key |
String : the name of the value to make null |
void remove (String key)
删除一个值。
Parameters | |
---|---|
key |
String : the name of the value to remove |
String toString ()
返回一个字符串,其中包含此对象的简明易懂的描述。
Returns | |
---|---|
String |
a printable representation of this object. |
Set<Entry<String, Object>> valueSet ()
返回一组所有的键和值
Returns | |
---|---|
Set<Entry<String, Object>> |
a set of all of the keys and values |
void writeToParcel (Parcel parcel, int flags)
将此对象平铺到一个包裹中。
Parameters | |
---|---|
parcel |
Parcel : The Parcel in which the object should be written. |
flags |
int : Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE . |