鸿蒙OS开发文档鸿蒙OS PacMap

2024-02-25 开发教程鸿蒙OS开发文档匿名 3℃

PacMap

java.lang.Object
|---ohos.utils.BasePacMap
|---|---ohos.utils.PacMap

public class PacMap
extends BasePacMap

提供支持Sequenceable操作的Map对象，可用于存储和读取字符串格式的键值对。

嵌套类摘要

从接口 ohos.utils.Sequenceable 继承的嵌套类/接口
Sequenceable.ProducerT

字段摘要

修饰符和类型	字段	描述
static PacMap	EMPTY_PAC_MAP	一个静态变量，表示一个空的 PacMap 对象。
static Sequenceable.ProducerPacMap	PRODUCER	指示用于创建 PacMap 实例的静态公共成员。

从类 ohos.utils.BasePacMap 继承的字段
dataMap

构造函数摘要

构造函数	描述
PacMap()	用于创建 PacMap 实例的默认构造函数，其中 Map 对象没有键值对。
PacMap(int capacity)	一个构造函数，用于创建一个 PacMap 实例，其键值对的数量由 Map 指定。

方法总结

修饰符和类型	方法	描述
void	clear()	清除当前对象。
Object	clone()	创建并返回此对象的副本。
PacMap	deepCopy()	创建此 PacMap 对象的深层副本。
boolean	equals(Object object)	指示其他对象是否“等于”这个对象。
MapString,Object	getAll()	获取已存储的所有数据。
boolean	getBooleanValue(String key)	获取与指定键匹配的布尔值。
boolean	getBooleanValue(String key, boolean defaultValue)	获取与指定键匹配的布尔值。
boolean[]	getBooleanValueArray(String key)	获取与指定键匹配的 boolean[] 值。
byte	getByteValue(String key)	获取与指定键匹配的字节值。
byte	getByteValue(String key, byte defaultValue)	获取与指定键匹配的字节值。
byte[]	getByteValueArray(String key)	获取匹配指定key的byte[]值。
char	getChar(String key)	获取与指定键匹配的字符值。
char	getChar(String key, char defaultValue)	获取与指定键匹配的字符值。
char[]	getCharArray(String key)	获取与指定键匹配的 char[] 值。
double	getDoubleValue(String key)	获取与指定键匹配的双精度值。
double	getDoubleValue(String key, double defaultValue)	获取与指定键匹配的双精度值。
double[]	getDoubleValueArray(String key)	获取与指定键匹配的 double[] 值。
float	getFloatValue(String key)	获取与指定键匹配的浮点值。
float	getFloatValue(String key, float defaultValue)	获取与指定键匹配的浮点值。
float[]	getFloatValueArray(String key)	获取与指定键匹配的 float[] 值。
ArrayListInteger	getIntegerList(String key)	获取与指定键匹配的 ArrayList<Integer> 值。
int	getIntValue(String key)	获取与指定键匹配的 int 值。
int	getIntValue(String key, int defaultValue)	获取与指定键匹配的 int 值。
int[]	getIntValueArray(String key)	获取与指定键匹配的 int[] 值。
SetString	getKeys()	获取当前对象的所有键。
long	getLongValue(String key)	获取与指定key匹配的long值。
long	getLongValue(String key, long defaultValue)	获取与指定key匹配的long值。
long[]	getLongValueArray(String key)	获取与指定键匹配的 long[] 值。
OptionalObject	getObjectValue(String key)	获取具有指定键的对象。
OptionalPacMap	getPacMap(String key)	获取与指定键匹配的 PacMap 值。
OptionalSequenceable	getSequenceable(String key)	获取与指定key匹配的Sequenceable值。
Sequenceable[]	getSequenceableArray(String key)	获取与指定键匹配的 Sequenceable[] 值。
ArrayListSequenceable	getSequenceableList(String key)	获取与指定键匹配的 ArrayList<Sequenceable> 值。
OptionalSerializable	getSerializable(String key)	获取与指定键匹配的 Serializable 值。
short	getShortValue(String key)	获取与指定键匹配的短值。
short	getShortValue(String key, short defaultValue)	获取与指定键匹配的短值。
short[]	getShortValueArray(String key)	获取与指定键匹配的 short[] 值。
int	getSize()	获取当前对象中存储的键值对的数量。
String	getString(String key)	获取与指定键匹配的字符串值。
String	getString(String key, String defaultValue)	获取与指定键匹配的字符串值。
String[]	getStringArray(String key)	获取与指定键匹配的 String[] 值。
ArrayListString	getStringList(String key)	获取与指定键匹配的 ArrayList<String> 值。
int	hashCode()	返回对象的哈希码值。
boolean	hasKey(String key)	检查是否包含指定的键。
boolean	isEmpty()	检查当前对象是否为空。
boolean	marshalling(Parcel out)	将此 Sequenceable 对象编组为 Parcel。
void	putAll(MapString,Object map)	将 Map 对象的所有键值对插入到内置数据对象中。
void	putAll(PacMap map)	将 PacMap 对象中的数据保存到当前对象。
void	putBooleanValue(String key, boolean value)	添加与指定键匹配的布尔值。
void	putBooleanValueArray(String key, boolean[] value)	添加与指定键匹配的 boolean[] 值。
void	putByteValue(String key, byte value)	添加与指定键匹配的字节值。
void	putByteValueArray(String key, byte[] value)	添加与指定键匹配的 byte[] 值。
void	putChar(String key, char value)	添加与指定键匹配的 char 值。
void	putCharArray(String key, char[] value)	添加与指定键匹配的 char[] 值。
void	putDoubleValue(String key, double value)	添加与指定键匹配的双精度值。
void	putDoubleValueArray(String key, double[] value)	添加与指定键匹配的 double[] 值。
void	putFloatValue(String key, float value)	添加与指定键匹配的浮点值。
void	putFloatValueArray(String key, float[] value)	添加与指定键匹配的 float[] 值。
void	putIntegerList(String key, ArrayListInteger value)	添加与指定键匹配的 ArrayList<Integer> 值。
void	putIntValue(String key, int value)	添加与指定键匹配的 int 值。
void	putIntValueArray(String key, int[] value)	添加与指定键匹配的 int[] 值。
void	putLongValue(String key, long value)	添加与指定键匹配的长值。
void	putLongValueArray(String key, long[] value)	添加与指定键匹配的 long[] 值。
void	putObjectValue(String key, Object value)	添加具有指定键的通用对象。
void	putPacMap(String key, PacMap pacMap)	添加与指定键匹配的 PacMap 值。
void	putSequenceableObject(String key, Sequenceable sequenceable)	添加与指定键匹配的 Sequenceable 值。
void	putSequenceableObjectArray(String key, Sequenceable[] sequenceables)	添加与指定键匹配的 Sequenceable[] 值。
void	putSequenceableObjectList(String key, ArrayListSequenceable sequenceables)	添加与指定键匹配的 ArrayList<Sequenceable> 值。
void	putSerializableObject(String key, Serializable serializable)	添加与指定键匹配的可序列化值。
void	putShortValue(String key, short value)	添加与指定键匹配的短值。
void	putShortValueArray(String key, short[] value)	添加一个与指定键匹配的 short[] 值。
void	putString(String key, String value)	添加与指定键匹配的字符串值。
void	putStringArray(String key, String[] value)	添加与指定键匹配的 String[] 值。
void	putStringList(String key, ArrayListString strings)	添加与指定键匹配的 ArrayList<String> 值。
void	remove(String key)	删除具有指定键的键值对。
boolean	unmarshalling(Parcel in)	从 Parcel 中解组此 Sequenceable 对象。

从类 ohos.utils.BasePacMap 继承的方法
getClassLoader, getDimension, getFloatDimension, getObjectValue, getPlainArray, getRemoteObject, hasFileDescriptor, putAll, putDimension, putFloatDimension, putPlainArray, putRemoteObject, setClassLoader

从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

字段详细信息

EMPTY_PAC_MAP

public static final PacMap EMPTY_PAC_MAP

一个静态变量，表示一个空的 PacMap 对象。

PRODUCER

public static final Sequenceable.ProducerPacMap PRODUCER

指示用于创建 PacMap 实例的静态公共成员。

构造函数详细信息

PacMap

public PacMap(int capacity)

一个构造函数，用于创建一个 PacMap 实例，其键值对的数量由 Map 指定。

参数：

参数名称	参数描述
capacity	表示 Map 指定的键值对的数量。

PacMap

public PacMap()

用于创建 PacMap 实例的默认构造函数，其中 Map 对象没有键值对。

方法详情

putAll

public void putAll(MapString,Object map)

将 Map 对象的所有键值对插入到内置数据对象中。

覆盖：

putAll 在 BasePacMap 类中

参数：

参数名称	参数描述
map	表示键为字符串的 Map 对象。

putAll

public void putAll(PacMap map)

将 PacMap 对象中的数据保存到当前对象。

参数：

参数名称	参数描述
map	指示要保存其数据的 PacMap 对象。

getAll

public MapString,Object getAll()

获取已存储的所有数据。

覆盖：

BasePacMap 类中的 getAll

返回一个包含字符串格式键的 Map 对象。

putObjectValue

public void putObjectValue(String key, Object value)

添加具有指定键的通用对象。如果已存在具有相同键的对象，则该对象将被添加的对象替换。

覆盖：

类 BasePacMap 中的 putObjectValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的对象。

putByteValue

public void putByteValue(String key, byte value)

添加与指定键匹配的字节值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

BasePacMap 类中的 putByteValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的字节值。

putShortValue

public void putShortValue(String key, short value)

添加与指定键匹配的短值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

BasePacMap 类中的 putShortValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的短值。

putIntValue

public void putIntValue(String key, int value)

添加与指定键匹配的 int 值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

BasePacMap 类中的 putIntValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的 int 值。

putLongValue

public void putLongValue(String key, long value)

添加与指定键匹配的长值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

类 BasePacMap 中的 putLongValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的长值。

putFloatValue

public void putFloatValue(String key, float value)

添加与指定键匹配的浮点值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

BasePacMap 类中的 putFloatValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的浮点值。

putDoubleValue

public void putDoubleValue(String key, double value)

添加与指定键匹配的双精度值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

类 BasePacMap 中的 putDoubleValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	指示要添加的双精度值。

putBooleanValue

public void putBooleanValue(String key, boolean value)

添加与指定键匹配的布尔值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

BasePacMap 类中的 putBooleanValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的布尔值。

putChar

public void putChar(String key, char value)

添加与指定键匹配的 char 值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

类 BasePacMap 中的 putChar

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的 char 值。

putString

public void putString(String key, String value)

添加与指定键匹配的字符串值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

类 BasePacMap 中的 putString

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的字符串值。

putByteValueArray

public void putByteValueArray(String key, byte[] value)

添加与指定键匹配的 byte[] 值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

BasePacMap 类中的 putByteValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的 byte[] 值。

putShortValueArray

public void putShortValueArray(String key, short[] value)

添加一个与指定键匹配的 short[] 值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

类 BasePacMap 中的 putShortValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的 short[] 值。

putIntValueArray

public void putIntValueArray(String key, int[] value)

添加与指定键匹配的 int[] 值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

BasePacMap 类中的 putIntValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	指示要添加的 int[] 值。

putIntegerList

public void putIntegerList(String key, ArrayListInteger value)

添加与指定键匹配的 ArrayList<Integer> 值。如果与键匹配的值已经存在，它将被添加的值替换。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	指示要添加的 ArrayList<Integer> 值。

putLongValueArray

public void putLongValueArray(String key, long[] value)

添加与指定键匹配的 long[] 值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

BasePacMap 类中的 putLongValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的 long[] 值。

putFloatValueArray

public void putFloatValueArray(String key, float[] value)

添加与指定键匹配的 float[] 值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

BasePacMap 类中的 putFloatValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	指示要添加的 float[] 值。

putDoubleValueArray

public void putDoubleValueArray(String key, double[] value)

添加与指定键匹配的 double[] 值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

类 BasePacMap 中的 putDoubleValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的 double[] 值。

putBooleanValueArray

public void putBooleanValueArray(String key, boolean[] value)

添加与指定键匹配的 boolean[] 值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

BasePacMap 类中的 putBooleanValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	指示要添加的 boolean[] 值。

putCharArray

public void putCharArray(String key, char[] value)

添加与指定键匹配的 char[] 值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

BasePacMap 类中的 putCharArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	表示要添加的 char[] 值。

putStringArray

public void putStringArray(String key, String[] value)

添加与指定键匹配的 String[] 值。如果与键匹配的值已经存在，它将被添加的值替换。

覆盖：

类 BasePacMap 中的 putStringArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
value	指示要添加的 String[] 值。

putStringList

public void putStringList(String key, ArrayListString strings)

添加与指定键匹配的 ArrayList<String> 值。如果与键匹配的值已经存在，它将被添加的值替换。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
strings	指示要添加的 ArrayList<String> 值。

putPacMap

public void putPacMap(String key, PacMap pacMap)

添加与指定键匹配的 PacMap 值。如果与键匹配的值已经存在，它将被添加的值替换。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
pacMap	指示要添加的 PacMap 值。

putSerializableObject

public void putSerializableObject(String key, Serializable serializable)

添加与指定键匹配的可序列化值。如果与键匹配的值已经存在，它将被添加的值替换。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
serializable	指示要添加的 Serializable 值。

putSequenceableObject

public void putSequenceableObject(String key, Sequenceable sequenceable)

添加与指定键匹配的 Sequenceable 值。如果与键匹配的值已经存在，它将被添加的值替换。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
sequenceable	指示要添加的 Sequenceable 值。

putSequenceableObjectArray

public void putSequenceableObjectArray(String key, Sequenceable[] sequenceables)

添加与指定键匹配的 Sequenceable[] 值。如果与键匹配的值已经存在，它将被添加的值替换。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
sequenceables	指示要添加的 Sequenceable[] 值。

putSequenceableObjectList

public void putSequenceableObjectList(String key, ArrayListSequenceable sequenceables)

添加与指定键匹配的 ArrayList<Sequenceable> 值。如果与键匹配的值已经存在，它将被添加的值替换。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
sequenceables	指示要添加的 ArrayList<Sequenceable> 值。

getObjectValue

public OptionalObject getObjectValue(String key)

获取具有指定键的对象。

覆盖：

BasePacMap 类中的 getObjectValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回指定key的对象，封装在Optional中；如果没有找到这样的对象，则返回 null。

getByteValue

public byte getByteValue(String key, byte defaultValue)

获取与指定键匹配的字节值。

覆盖：

BasePacMap 类中的 getByteValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
defaultValue	表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回匹配指定键的字节值；如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getByteValue

public byte getByteValue(String key)

获取与指定键匹配的字节值。

覆盖：

BasePacMap 类中的 getByteValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回匹配指定键的字节值；如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getShortValue

public short getShortValue(String key, short defaultValue)

获取与指定键匹配的短值。

覆盖：

BasePacMap 类中的 getShortValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
defaultValue	表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回与指定键匹配的短值；如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getShortValue

public short getShortValue(String key)

获取与指定键匹配的短值。

覆盖：

BasePacMap 类中的 getShortValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的短值；如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getIntValue

public int getIntValue(String key, int defaultValue)

获取与指定键匹配的 int 值。

覆盖：

BasePacMap 类中的 getIntValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
defaultValue	表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回与指定键匹配的 int 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getIntValue

public int getIntValue(String key)

获取与指定键匹配的 int 值。

覆盖：

BasePacMap 类中的 getIntValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 int 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getLongValue

public long getLongValue(String key, long defaultValue)

获取与指定key匹配的long值。

覆盖：

类 BasePacMap 中的 getLongValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
defaultValue	表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回匹配指定key的long值；如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getLongValue

public long getLongValue(String key)

获取与指定key匹配的long值。

覆盖：

类 BasePacMap 中的 getLongValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回匹配指定key的long值；如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getFloatValue

public float getFloatValue(String key, float defaultValue)

获取与指定键匹配的浮点值。

覆盖：

BasePacMap 类中的 getFloatValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
defaultValue	表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回与指定键匹配的浮点值；如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getFloatValue

public float getFloatValue(String key)

获取与指定键匹配的浮点值。

覆盖：

BasePacMap 类中的 getFloatValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的浮点值；如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getDoubleValue

public double getDoubleValue(String key, double defaultValue)

获取与指定键匹配的双精度值。

覆盖：

BasePacMap 类中的 getDoubleValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
defaultValue	表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回与指定键匹配的双精度值；如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getDoubleValue

public double getDoubleValue(String key)

获取与指定键匹配的双精度值。

覆盖：

BasePacMap 类中的 getDoubleValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的双精度值；如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getBooleanValue

public boolean getBooleanValue(String key, boolean defaultValue)

获取与指定键匹配的布尔值。

覆盖：

BasePacMap 类中的 getBooleanValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
defaultValue	表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回与指定键匹配的布尔值；如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getBooleanValue

public boolean getBooleanValue(String key)

获取与指定键匹配的布尔值。

覆盖：

BasePacMap 类中的 getBooleanValue

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的布尔值；如果没有找到与键匹配的值或找到其他类型的值，则返回 false。

getChar

public char getChar(String key, char defaultValue)

获取与指定键匹配的字符值。

覆盖：

BasePacMap 类中的 getChar

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
defaultValue	表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回与指定键匹配的 char 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getChar

public char getChar(String key)

获取与指定键匹配的字符值。

覆盖：

BasePacMap 类中的 getChar

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 char 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getString

public String getString(String key, String defaultValue)

获取与指定键匹配的字符串值。

覆盖：

类 BasePacMap 中的 getString

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。
defaultValue	表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回与指定键匹配的字符串值；如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getString

public String getString(String key)

获取与指定键匹配的字符串值。

覆盖：

类 BasePacMap 中的 getString

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的字符串值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getByteValueArray

public byte[] getByteValueArray(String key)

获取匹配指定key的byte[]值。

覆盖：

类 BasePacMap 中的 getByteValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回匹配指定key的byte[]值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getShortValueArray

public short[] getShortValueArray(String key)

获取与指定键匹配的 short[] 值。

覆盖：

BasePacMap 类中的 getShortValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 short[] 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getIntValueArray

public int[] getIntValueArray(String key)

获取与指定键匹配的 int[] 值。

覆盖：

类 BasePacMap 中的 getIntValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 int[] 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getIntegerList

public ArrayListInteger getIntegerList(String key)

获取与指定键匹配的 ArrayList<Integer> 值。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 ArrayList<Integer> 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getLongValueArray

public long[] getLongValueArray(String key)

获取与指定键匹配的 long[] 值。

覆盖：

BasePacMap 类中的 getLongValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 long[] 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getFloatValueArray

public float[] getFloatValueArray(String key)

获取与指定键匹配的 float[] 值。

覆盖：

类 BasePacMap 中的 getFloatValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 float[] 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getDoubleValueArray

public double[] getDoubleValueArray(String key)

获取与指定键匹配的 double[] 值。

覆盖：

类 BasePacMap 中的 getDoubleValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 double[] 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getBooleanValueArray

public boolean[] getBooleanValueArray(String key)

获取与指定键匹配的 boolean[] 值。

覆盖：

类 BasePacMap 中的 getBooleanValueArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 boolean[] 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getCharArray

public char[] getCharArray(String key)

获取与指定键匹配的 char[] 值。

覆盖：

类 BasePacMap 中的 getCharArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 char[] 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getStringArray

public String[] getStringArray(String key)

获取与指定键匹配的 String[] 值。

覆盖：

BasePacMap 类中的 getStringArray

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 String[] 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getStringList

public ArrayListString getStringList(String key)

获取与指定键匹配的 ArrayList<String> 值。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 ArrayList<String> 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getPacMap

public OptionalPacMap getPacMap(String key)

获取与指定键匹配的 PacMap 值。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回 PacMap 值，封装在 Optional 中；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getSerializable

public OptionalSerializable getSerializable(String key)

获取与指定键匹配的 Serializable 值。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回 Serializable 值，封装在 Optional 中；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getSequenceable

public OptionalSequenceable getSequenceable(String key)

获取与指定key匹配的Sequenceable值。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回 Seqenceable 值，封装在 Optional 中；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getSequenceableArray

public Sequenceable[] getSequenceableArray(String key)

获取与指定键匹配的 Sequenceable[] 值。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 Sequenceable[] 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getSequenceableList

public ArrayListSequenceable getSequenceableList(String key)

获取与指定键匹配的 ArrayList<Sequenceable> 值。

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

返回与指定键匹配的 ArrayList<Sequenceable> 值；如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getSize

public int getSize()

获取当前对象中存储的键值对的数量。

覆盖：

BasePacMap 类中的 getSize

返回键值对的数量。

isEmpty

public boolean isEmpty()

检查当前对象是否为空。

覆盖：

BasePacMap 类中的 isEmpty

如果当前对象为空，则返回 true；否则返回 false。

getKeys

public SetString getKeys()

获取当前对象的所有键。

覆盖：

BasePacMap 类中的 getKeys

返回当前对象的所有键。

hasKey

public boolean hasKey(String key)

检查是否包含指定的键。

覆盖：

BasePacMap 类中的 hasKey

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

如果包含键，则返回 true；否则返回 false。

remove

public void remove(String key)

删除具有指定键的键值对。

覆盖：

在类 BasePacMap 中删除

参数：

参数名称	参数描述
key	表示String格式的key，可以为null。

clear

public void clear()

清除当前对象。

覆盖：

在 BasePacMap 类中清除

marshalling

public boolean marshalling(Parcel out)

将此 Sequenceable 对象编组为 Parcel。

指定者：

接口 Sequenceable 中的编组

覆盖：

BasePacMap 类中的编组

参数：

参数名称	参数描述
out	指示 Sequenceable 对象将被编组到的 Parcel 对象。

如果编组成功，则返回 true；否则返回 false。

unmarshalling

public boolean unmarshalling(Parcel in)

从 Parcel 中解组此 Sequenceable 对象。

指定者：

在接口 Sequenceable 中解组

覆盖：

在 BasePacMap 类中解组

参数：

参数名称	参数描述
in	指示已将 Sequenceable 对象编组到的 Parcel 对象。

如果解组成功，则返回 true；否则返回 false。

equals

public boolean equals(Object object)

从类复制的描述：对象

指示其他对象是否“等于”这个对象。

equals 方法在非空对象引用上实现等价关系：

它是自反的：对于任何非空引用值 x，x.equals(x) 应该返回 true。
它是对称的：对于任何非空引用值 x 和 y，当且仅当 y.equals(x) 返回 true 时，x.equals(y) 才应该返回 true。
它是可传递的：对于任何非空引用值 x、y 和 z，如果 x.equals(y) 返回 true 并且 y.equals(z) 返回 true，则 x.equals(z) 应该返回 true。
它是一致的：对于任何非空引用值 x 和 y，x.equals(y) 的多次调用始终返回 true 或始终返回 false，前提是没有修改对象上 equals 比较中使用的信息。
对于任何非空引用值 x，x.equals(null) 应该返回 false。

Object 类的 equals 方法实现了对象上最有区别的可能等价关系；也就是说，对于任何非空引用值 x 和 y，当且仅当 x 和 y 引用同一个对象（x == y 的值为 true）时，此方法才返回 true。

请注意，每当重写该方法时，通常都需要重写 hashCode 方法，以维护 hashCode 方法的一般约定，即相等的对象必须具有相等的哈希码。

覆盖：

类 BasePacMap 中的等于

参数：

参数名称	参数描述
object	要与之比较的参考对象。

如果此对象与 obj 参数相同，则为 true；否则为 false。

hashCode

public int hashCode()

从类复制的描述：对象

返回对象的哈希码值。支持这种方法是为了有利于哈希表，例如 HashMap 提供的那些。

hashCode 的一般合约是：

每当在 Java 应用程序执行期间对同一对象多次调用时，hashCode 方法必须始终返回相同的整数，前提是没有修改对象上相等比较中使用的信息。该整数不需要从应用程序的一次执行到同一应用程序的另一次执行保持一致。
如果两个对象根据 equals(Object) 方法相等，则对两个对象中的每一个调用 hashCode 方法必须产生相同的整数结果。
如果根据 Object.equals(java.lang.Object) 方法，如果两个对象不相等，则不要求对两个对象中的每一个调用 hashCode 方法必须产生不同的整数结果。但是，程序员应该意识到，为不相等的对象生成不同的整数结果可能会提高哈希表的性能。

在合理可行的情况下，由 Object 类定义的 hashCode 方法确实为不同的对象返回不同的整数。（这通常通过将对象的内部地址转换为整数来实现，但 Java™ 编程语言不需要这种实现技术。）

覆盖：

BasePacMap 类中的 hashCode

此对象的哈希码值。

clone

public Object clone() throws CloneNotSupportedException

从类复制的描述：对象

创建并返回此对象的副本。 “复制”的确切含义可能取决于对象的类别。一般意图是，对于任何对象 x，表达式：

x.clone() != x

将为 true，并且表达式：

x.clone().getClass() == x.getClass()

将为 true，但这些不是绝对的要求。虽然通常是这样的：

x.clone().equals(x)

将为 true，这不是一个绝对的要求。

按照约定，返回的对象应该通过调用 super.clone 来获取。如果一个类及其所有超类（Object 除外）都遵守这个约定，那么 x.clone().getClass() == x.getClass() 就是这种情况。

按照惯例，此方法返回的对象应独立于此对象（正在克隆）。为了实现这种独立性，可能需要在返回 super.clone 之前修改对象的一个或多个字段。通常，这意味着复制任何包含被克隆对象的内部“深层结构”的可变对象，并将对这些对象的引用替换为对副本的引用。如果一个类只包含原始字段或对不可变对象的引用，那么通常情况下 super.clone 返回的对象中不需要修改任何字段。

类 Object 的方法 clone 执行特定的克隆操作。首先，如果该对象的类没有实现接口 Cloneable，则抛出 CloneNotSupportedException。请注意，所有数组都被认为实现了接口 Cloneable，并且数组类型 T[] 的克隆方法的返回类型是 T[]，其中 T 是任何引用或原始类型。否则，此方法会创建此对象的类的新实例，并使用此对象的相应字段的内容来初始化其所有字段，就像通过赋值一样；字段的内容本身不会被克隆。因此，此方法执行此对象的“浅拷贝”，而不是“深拷贝”操作。

Object 类本身并没有实现接口 Cloneable，因此在类为 Object 的对象上调用 clone 方法将导致在运行时抛出异常。

覆盖：

在 BasePacMap 类中克隆

此实例的克隆。

Throws:

Throw名称	Throw描述
CloneNotSupportedException	如果对象的类不支持 Cloneable 接口。覆盖 clone 方法的子类也可以抛出此异常，表示无法克隆实例。

deepCopy

public PacMap deepCopy()

创建此 PacMap 对象的深层副本。

执行深拷贝以创建与原始对象具有相同内容的对象。

注意：深拷贝仅支持原始数据类型、对象、它们的数组和 PacMap。

返回 PacMap 对象的深层副本。

上一节：鸿蒙OS ObjectAttribute

下一节：鸿蒙OS Pair

"鸿蒙OS开发文档"的目录

鸿蒙OS开发文档 鸿蒙OS PacMap

PacMap

嵌套类摘要

字段摘要

构造函数摘要

方法总结

字段详细信息

EMPTY_PAC_MAP

PRODUCER

构造函数详细信息

PacMap

PacMap

方法详情

putAll

putAll

getAll

putObjectValue

putByteValue

putShortValue

putIntValue

putLongValue

putFloatValue

putDoubleValue

putBooleanValue

putChar

putString

putByteValueArray

putShortValueArray

putIntValueArray

putIntegerList

putLongValueArray

putFloatValueArray

putDoubleValueArray

putBooleanValueArray

putCharArray

putStringArray

putStringList

putPacMap

putSerializableObject

putSequenceableObject

putSequenceableObjectArray

putSequenceableObjectList

getObjectValue

getByteValue

getByteValue

getShortValue

getShortValue

getIntValue

getIntValue

getLongValue

getLongValue

getFloatValue

getFloatValue

getDoubleValue

getDoubleValue

getBooleanValue

getBooleanValue

getChar

getChar

getString

getString

getByteValueArray

getShortValueArray

getIntValueArray

getIntegerList

getLongValueArray

getFloatValueArray

getDoubleValueArray

getBooleanValueArray

getCharArray

getStringArray

getStringList

getPacMap

getSerializable

getSequenceable

getSequenceableArray

getSequenceableList

getSize

isEmpty

鸿蒙OS开发文档鸿蒙OS PacMap