added in API level 21

PersistableBundle

public final class PersistableBundle
extends BaseBundle implements Cloneable, Parcelable

java.lang.Object
↳	android.os.BaseBundle
	↳	android.os.PersistableBundle

A mapping from String keys to values of various types. The set of types supported by this class is purposefully restricted to simple objects that can safely be persisted to and restored from disk.

See also:

Bundle

Summary

Inherited constants

From interface


    android.os.Parcelable

Fields
`public static final Creator<PersistableBundle>`	`CREATOR`
`public static final PersistableBundle`	`EMPTY`

Public constructors
`PersistableBundle()` Constructs a new, empty PersistableBundle.
`PersistableBundle(int capacity)` Constructs a new, empty PersistableBundle sized to hold the given number of elements.
`PersistableBundle(PersistableBundle b)` Constructs a PersistableBundle containing a copy of the mappings from the given PersistableBundle.

Public methods
`Object`	`clone()` Clones the current PersistableBundle.
`PersistableBundle`	`deepCopy()` Make a deep copy of the given bundle.
`int`	`describeContents()` Report the nature of this Parcelable's contents
`PersistableBundle`	`getPersistableBundle(String key)` Returns the value associated with the given key, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key.
`void`	`putPersistableBundle(String key, PersistableBundle value)` Inserts a PersistableBundle value into the mapping of this Bundle, replacing any existing value for the given key.
`String`	`toString()` Returns a string representation of the object.
`void`	`writeToParcel(Parcel parcel, int flags)` Writes the PersistableBundle contents to a Parcel, typically in order for it to be passed through an IBinder connection.

Inherited methods

From class


  
    android.os.BaseBundle

`void`	`clear()` Removes all elements from the mapping of this Bundle.
`boolean`	`containsKey(String key)` Returns true if the given key is contained in the mapping of this Bundle.
`Object`	`get(String key)` Returns the entry with the given key as an object.
`boolean`	`getBoolean(String key, boolean defaultValue)` Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.
`boolean`	`getBoolean(String key)` Returns the value associated with the given key, or false if no mapping of the desired type exists for the given key.
`boolean[]`	`getBooleanArray(String key)` Returns the value associated with the given key, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key.
`double`	`getDouble(String key, double defaultValue)` Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.
`double`	`getDouble(String key)` Returns the value associated with the given key, or 0.0 if no mapping of the desired type exists for the given key.
`double[]`	`getDoubleArray(String key)` Returns the value associated with the given key, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key.
`int`	`getInt(String key)` Returns the value associated with the given key, or 0 if no mapping of the desired type exists for the given key.
`int`	`getInt(String key, int defaultValue)` Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.
`int[]`	`getIntArray(String key)` Returns the value associated with the given key, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key.
`long`	`getLong(String key)` Returns the value associated with the given key, or 0L if no mapping of the desired type exists for the given key.
`long`	`getLong(String key, long defaultValue)` Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.
`long[]`	`getLongArray(String key)` Returns the value associated with the given key, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key.
`String`	`getString(String key)` Returns the value associated with the given key, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key.
`String`	`getString(String key, String defaultValue)` Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key or if a null value is explicitly associated with the given key.
`String[]`	`getStringArray(String key)` Returns the value associated with the given key, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key.
`boolean`	`isEmpty()` Returns true if the mapping of this Bundle is empty, false otherwise.
`Set<String>`	`keySet()` Returns a Set containing the Strings used as keys in this Bundle.
`void`	`putAll(PersistableBundle bundle)` Inserts all mappings from the given PersistableBundle into this BaseBundle.
`void`	`putBoolean(String key, boolean value)` Inserts a Boolean value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putBooleanArray(String key, boolean[] value)` Inserts a boolean array value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putDouble(String key, double value)` Inserts a double value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putDoubleArray(String key, double[] value)` Inserts a double array value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putInt(String key, int value)` Inserts an int value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putIntArray(String key, int[] value)` Inserts an int array value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putLong(String key, long value)` Inserts a long value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putLongArray(String key, long[] value)` Inserts a long array value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putString(String key, String value)` Inserts a String value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putStringArray(String key, String[] value)` Inserts a String array value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`remove(String key)` Removes any entry with the given key from the mapping of this Bundle.
`int`	`size()` Returns the number of mappings contained in this Bundle.

From class


  
    java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

From interface


  
    android.os.Parcelable

Fields

CREATOR

added in API level 21

Creator<PersistableBundle> CREATOR

EMPTY

added in API level 21

PersistableBundle EMPTY

Public constructors

PersistableBundle

added in API level 21

PersistableBundle ()

Constructs a new, empty PersistableBundle.

PersistableBundle

added in API level 21

PersistableBundle (int capacity)

Constructs a new, empty PersistableBundle sized to hold the given number of elements. The PersistableBundle will grow as needed.

Parameters
`capacity`	`int`: the initial capacity of the PersistableBundle

PersistableBundle

added in API level 21

PersistableBundle (PersistableBundle b)

Constructs a PersistableBundle containing a copy of the mappings from the given PersistableBundle. Does only a shallow copy of the original PersistableBundle -- see deepCopy() if that is not what you want.

Parameters
`b`	`PersistableBundle`: a PersistableBundle to be copied.

See also:

deepCopy()

Public methods

clone

added in API level 21

Object clone ()

Clones the current PersistableBundle. The internal map is cloned, but the keys and values to which it refers are copied by reference.

Returns
`Object`	a clone of this instance.

deepCopy

Android O Developer Preview

PersistableBundle deepCopy ()

Make a deep copy of the given bundle. Traverses into inner containers and copies them as well, so they are not shared across bundles. Will traverse in to Bundle, PersistableBundle, ArrayList, and all types of primitive arrays. Other types of objects (such as Parcelable or Serializable) are referenced as-is and not copied in any way.

Returns
`PersistableBundle`

describeContents

added in API level 21

int describeContents ()

Report the nature of this Parcelable's contents

Returns
`int`	a bitmask indicating the set of special object types marshaled by this Parcelable object instance.

getPersistableBundle

added in API level 21

PersistableBundle getPersistableBundle (String key)

Returns the value associated with the given key, or null if no mapping of the desired type exists for the given key or a null value is explicitly associated with the key.

Parameters
`key`	`String`: a String, or null This value may be `null`.

Returns
`PersistableBundle`	a Bundle value, or null This value may be `null`.

putPersistableBundle

added in API level 21

void putPersistableBundle (String key, 
                PersistableBundle value)

Inserts a PersistableBundle value into the mapping of this Bundle, replacing any existing value for the given key. Either key or value may be null.

Parameters
`key`	`String`: a String, or null This value may be `null`.
`value`	`PersistableBundle`: a Bundle object, or null This value may be `null`.

toString

added in API level 21

String toString ()

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

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

Returns
`String`	a string representation of the object.

writeToParcel

added in API level 21

void writeToParcel (Parcel parcel, 
                int flags)

Writes the PersistableBundle contents to a Parcel, typically in order for it to be passed through an IBinder connection.

Parameters
`parcel`	`Parcel`: The parcel to copy this bundle to.
`flags`	`int`: Additional flags about how the object should be written. May be 0 or `PARCELABLE_WRITE_RETURN_VALUE`.

Most visited

Recently visited

Results for

PersistableBundle

Summary

Inherited constants

Fields

Public constructors

Public methods

Inherited methods

Fields

CREATOR

EMPTY

Public constructors

PersistableBundle

PersistableBundle

PersistableBundle

Public methods

clone

deepCopy

describeContents

getPersistableBundle

putPersistableBundle

toString

writeToParcel

Interfaces

Classes

Enums

Exceptions