added in API level 1

Bundle

public final class Bundle
extends BaseBundle implements Cloneable, Parcelable

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

A mapping from String keys to various Parcelable values.

See also:

PersistableBundle

Summary

Inherited constants

From interface


    android.os.Parcelable

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

Public constructors
`Bundle()` Constructs a new, empty Bundle.
`Bundle(ClassLoader loader)` Constructs a new, empty Bundle that uses a specific ClassLoader for instantiating Parcelable and Serializable objects.
`Bundle(int capacity)` Constructs a new, empty Bundle sized to hold the given number of elements.
`Bundle(Bundle b)` Constructs a Bundle containing a copy of the mappings from the given Bundle.
`Bundle(PersistableBundle b)` Constructs a Bundle containing a copy of the mappings from the given PersistableBundle.

Public methods
`void`	`clear()` Removes all elements from the mapping of this Bundle.
`Object`	`clone()` Clones the current Bundle.
`Bundle`	`deepCopy()` Make a deep copy of the given bundle.
`int`	`describeContents()` Report the nature of this Parcelable's contents
`IBinder`	`getBinder(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.
`Bundle`	`getBundle(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.
`byte`	`getByte(String key)` Returns the value associated with the given key, or (byte) 0 if no mapping of the desired type exists for the given key.
`Byte`	`getByte(String key, byte defaultValue)` Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.
`byte[]`	`getByteArray(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.
`char`	`getChar(String key)` Returns the value associated with the given key, or (char) 0 if no mapping of the desired type exists for the given key.
`char`	`getChar(String key, char defaultValue)` Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.
`char[]`	`getCharArray(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.
`CharSequence`	`getCharSequence(String key, CharSequence 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 associatd with the given key.
`CharSequence`	`getCharSequence(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.
`CharSequence[]`	`getCharSequenceArray(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.
`ArrayList<CharSequence>`	`getCharSequenceArrayList(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.
`ClassLoader`	`getClassLoader()` Return the ClassLoader currently associated with this Bundle.
`float`	`getFloat(String key, float defaultValue)` Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.
`float`	`getFloat(String key)` Returns the value associated with the given key, or 0.0f if no mapping of the desired type exists for the given key.
`float[]`	`getFloatArray(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.
`ArrayList<Integer>`	`getIntegerArrayList(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.
`<T extends Parcelable> T`	`getParcelable(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.
`Parcelable[]`	`getParcelableArray(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.
`<T extends Parcelable> ArrayList<T>`	`getParcelableArrayList(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.
`Serializable`	`getSerializable(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.
`short`	`getShort(String key)` Returns the value associated with the given key, or (short) 0 if no mapping of the desired type exists for the given key.
`short`	`getShort(String key, short defaultValue)` Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.
`short[]`	`getShortArray(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.
`Size`	`getSize(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.
`SizeF`	`getSizeF(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.
`<T extends Parcelable> SparseArray<T>`	`getSparseParcelableArray(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.
`ArrayList<String>`	`getStringArrayList(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`	`hasFileDescriptors()` Reports whether the bundle contains any parcelled file descriptors.
`void`	`putAll(Bundle bundle)` Inserts all mappings from the given Bundle into this Bundle.
`void`	`putBinder(String key, IBinder value)` Inserts an `IBinder` value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putBundle(String key, Bundle value)` Inserts a Bundle value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putByte(String key, byte value)` Inserts a byte value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putByteArray(String key, byte[] value)` Inserts a byte array value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putChar(String key, char value)` Inserts a char value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putCharArray(String key, char[] value)` Inserts a char array value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putCharSequence(String key, CharSequence value)` Inserts a CharSequence value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putCharSequenceArray(String key, CharSequence[] value)` Inserts a CharSequence array value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putCharSequenceArrayList(String key, ArrayList<CharSequence> value)` Inserts an ArrayList value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putFloat(String key, float value)` Inserts a float value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putFloatArray(String key, float[] value)` Inserts a float array value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putIntegerArrayList(String key, ArrayList<Integer> value)` Inserts an ArrayList value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putParcelable(String key, Parcelable value)` Inserts a Parcelable value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putParcelableArray(String key, Parcelable[] value)` Inserts an array of Parcelable values into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putParcelableArrayList(String key, ArrayList<? extends Parcelable> value)` Inserts a List of Parcelable values into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putSerializable(String key, Serializable value)` Inserts a Serializable value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putShort(String key, short value)` Inserts a short value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putShortArray(String key, short[] value)` Inserts a short array value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putSize(String key, Size value)` Inserts a Size value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putSizeF(String key, SizeF value)` Inserts a SizeF value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putSparseParcelableArray(String key, SparseArray<? extends Parcelable> value)` Inserts a SparceArray of Parcelable values into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`putStringArrayList(String key, ArrayList<String> value)` Inserts an ArrayList value into the mapping of this Bundle, replacing any existing value for the given key.
`void`	`readFromParcel(Parcel parcel)` Reads the Parcel contents into this Bundle, typically in order for it to be passed through an IBinder connection.
`void`	`remove(String key)` Removes any entry with the given key from the mapping of this Bundle.
`void`	`setClassLoader(ClassLoader loader)` Changes the ClassLoader this Bundle uses when instantiating objects.
`String`	`toString()` Returns a string representation of the object.
`void`	`writeToParcel(Parcel parcel, int flags)` Writes the Bundle 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 1

Creator<Bundle> CREATOR

EMPTY

added in API level 1

Bundle EMPTY

Public constructors

Bundle

added in API level 1

Bundle ()

Constructs a new, empty Bundle.

Bundle

added in API level 1

Bundle (ClassLoader loader)

Constructs a new, empty Bundle that uses a specific ClassLoader for instantiating Parcelable and Serializable objects.

Parameters
`loader`	`ClassLoader`: An explicit ClassLoader to use when instantiating objects inside of the Bundle.

Bundle

added in API level 1

Bundle (int capacity)

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

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

Bundle

added in API level 1

Bundle (Bundle b)

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

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

See also:

deepCopy()

Bundle

added in API level 21

Bundle (PersistableBundle b)

Constructs a Bundle containing a copy of the mappings from the given PersistableBundle. Does only a shallow copy of the PersistableBundle -- see deepCopy() if you don't want that.

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

Public methods

clear

added in API level 1

void clear ()

Removes all elements from the mapping of this Bundle.

clone

added in API level 1

Object clone ()

Clones the current Bundle. 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

Bundle 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
`Bundle`

describeContents

added in API level 1

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.

getBinder

added in API level 18

IBinder getBinder (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
`IBinder`	an IBinder value, or null This value may be `null`.

getBundle

added in API level 1

Bundle getBundle (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
`Bundle`	a Bundle value, or null This value may be `null`.

getByte

added in API level 1

byte getByte (String key)

Returns the value associated with the given key, or (byte) 0 if no mapping of the desired type exists for the given key.

Parameters
`key`	`String`: a String

Returns
`byte`	a byte value

getByte

added in API level 1

Byte getByte (String key, 
                byte defaultValue)

Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.

Parameters
`key`	`String`: a String
`defaultValue`	`byte`: Value to return if key does not exist

Returns
`Byte`	a byte value

getByteArray

added in API level 1

byte[] getByteArray (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
`byte[]`	a byte[] value, or null This value may be `null`.

getChar

added in API level 1

char getChar (String key)

Returns the value associated with the given key, or (char) 0 if no mapping of the desired type exists for the given key.

Parameters
`key`	`String`: a String

Returns
`char`	a char value

getChar

added in API level 1

char getChar (String key, 
                char defaultValue)

Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.

Parameters
`key`	`String`: a String
`defaultValue`	`char`: Value to return if key does not exist

Returns
`char`	a char value

getCharArray

added in API level 1

char[] getCharArray (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
`char[]`	a char[] value, or null This value may be `null`.

getCharSequence

added in API level 12

CharSequence getCharSequence (String key, 
                CharSequence 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 associatd with the given key.

Parameters
`key`	`String`: a String, or null This value may be `null`.
`defaultValue`	`CharSequence`: Value to return if key does not exist or if a null value is associated with the given key.

Returns
`CharSequence`	the CharSequence value associated with the given key, or defaultValue if no valid CharSequence object is currently mapped to that key.

getCharSequence

added in API level 1

CharSequence getCharSequence (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
`CharSequence`	a CharSequence value, or null This value may be `null`.

getCharSequenceArray

added in API level 8

CharSequence[] getCharSequenceArray (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
`CharSequence[]`	a CharSequence[] value, or null This value may be `null`.

getCharSequenceArrayList

added in API level 8

ArrayList<CharSequence> getCharSequenceArrayList (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
`ArrayList<CharSequence>`	an ArrayList value, or null This value may be `null`.

getClassLoader

added in API level 11

ClassLoader getClassLoader ()

Return the ClassLoader currently associated with this Bundle.

Returns
`ClassLoader`

getFloat

added in API level 1

float getFloat (String key, 
                float defaultValue)

Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.

Parameters
`key`	`String`: a String
`defaultValue`	`float`: Value to return if key does not exist

Returns
`float`	a float value

getFloat

added in API level 1

float getFloat (String key)

Returns the value associated with the given key, or 0.0f if no mapping of the desired type exists for the given key.

Parameters
`key`	`String`: a String

Returns
`float`	a float value

getFloatArray

added in API level 1

float[] getFloatArray (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
`float[]`	a float[] value, or null This value may be `null`.

getIntegerArrayList

added in API level 1

ArrayList<Integer> getIntegerArrayList (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
`ArrayList<Integer>`	an ArrayList value, or null This value may be `null`.

getParcelable

added in API level 1

T getParcelable (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
`T`	a Parcelable value, or null This value may be `null`.

getParcelableArray

added in API level 1

Parcelable[] getParcelableArray (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
`Parcelable[]`	a Parcelable[] value, or null This value may be `null`.

getParcelableArrayList

added in API level 1

ArrayList<T> getParcelableArrayList (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
`ArrayList<T>`	an ArrayList value, or null This value may be `null`.

getSerializable

added in API level 1

Serializable getSerializable (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
`Serializable`	a Serializable value, or null This value may be `null`.

getShort

added in API level 1

short getShort (String key)

Returns the value associated with the given key, or (short) 0 if no mapping of the desired type exists for the given key.

Parameters
`key`	`String`: a String

Returns
`short`	a short value

getShort

added in API level 1

short getShort (String key, 
                short defaultValue)

Returns the value associated with the given key, or defaultValue if no mapping of the desired type exists for the given key.

Parameters
`key`	`String`: a String
`defaultValue`	`short`: Value to return if key does not exist

Returns
`short`	a short value

getShortArray

added in API level 1

short[] getShortArray (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
`short[]`	a short[] value, or null This value may be `null`.

getSize

added in API level 21

Size getSize (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
`Size`	a Size value, or null This value may be `null`.

getSizeF

added in API level 21

SizeF getSizeF (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
`SizeF`	a Size value, or null This value may be `null`.

getSparseParcelableArray

added in API level 1

SparseArray<T> getSparseParcelableArray (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
`SparseArray<T>`	a SparseArray of T values, or null This value may be `null`.

getStringArrayList

added in API level 1

ArrayList<String> getStringArrayList (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
`ArrayList<String>`	an ArrayList value, or null This value may be `null`.

hasFileDescriptors

added in API level 1

boolean hasFileDescriptors ()

Reports whether the bundle contains any parcelled file descriptors.

Returns
`boolean`

putAll

added in API level 1

void putAll (Bundle bundle)

Inserts all mappings from the given Bundle into this Bundle.

Parameters
`bundle`	`Bundle`: a Bundle

putBinder

added in API level 18

void putBinder (String key, 
                IBinder value)

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

You should be very careful when using this function. In many places where Bundles are used (such as inside of Intent objects), the Bundle can live longer inside of another process than the process that had originally created it. In that case, the IBinder you supply here will become invalid when your process goes away, and no longer usable, even if a new process is created for you later on.

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

putBundle

added in API level 1

void putBundle (String key, 
                Bundle value)

Inserts a Bundle 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`	`Bundle`: a Bundle object, or null This value may be `null`.

putByte

added in API level 1

void putByte (String key, 
                byte value)

Inserts a byte value into the mapping of this Bundle, replacing any existing value for the given key.

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

putByteArray

added in API level 1

void putByteArray (String key, 
                byte[] value)

Inserts a byte array 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`	`byte`: a byte array object, or null This value may be `null`.

putChar

added in API level 1

void putChar (String key, 
                char value)

Inserts a char value into the mapping of this Bundle, replacing any existing value for the given key.

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

putCharArray

added in API level 1

void putCharArray (String key, 
                char[] value)

Inserts a char array 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`	`char`: a char array object, or null This value may be `null`.

putCharSequence

added in API level 1

void putCharSequence (String key, 
                CharSequence value)

Inserts a CharSequence 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`	`CharSequence`: a CharSequence, or null This value may be `null`.

putCharSequenceArray

added in API level 8

void putCharSequenceArray (String key, 
                CharSequence[] value)

Inserts a CharSequence array 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`	`CharSequence`: a CharSequence array object, or null This value may be `null`.

putCharSequenceArrayList

added in API level 8

void putCharSequenceArrayList (String key, 
                ArrayList<CharSequence> value)

Inserts an ArrayList 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`	`ArrayList`: an ArrayList object, or null This value may be `null`.

putFloat

added in API level 1

void putFloat (String key, 
                float value)

Inserts a float value into the mapping of this Bundle, replacing any existing value for the given key.

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

putFloatArray

added in API level 1

void putFloatArray (String key, 
                float[] value)

Inserts a float array 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`	`float`: a float array object, or null This value may be `null`.

putIntegerArrayList

added in API level 1

void putIntegerArrayList (String key, 
                ArrayList<Integer> value)

Inserts an ArrayList 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`	`ArrayList`: an ArrayList object, or null This value may be `null`.

putParcelable

added in API level 1

void putParcelable (String key, 
                Parcelable value)

Inserts a Parcelable 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`	`Parcelable`: a Parcelable object, or null This value may be `null`.

putParcelableArray

added in API level 1

void putParcelableArray (String key, 
                Parcelable[] value)

Inserts an array of Parcelable values 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`	`Parcelable`: an array of Parcelable objects, or null This value may be `null`.

putParcelableArrayList

added in API level 1

void putParcelableArrayList (String key, 
                ArrayList<? extends Parcelable> value)

Inserts a List of Parcelable values 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`	`ArrayList`: an ArrayList of Parcelable objects, or null This value may be `null`.

putSerializable

added in API level 1

void putSerializable (String key, 
                Serializable value)

Inserts a Serializable 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`	`Serializable`: a Serializable object, or null This value may be `null`.

putShort

added in API level 1

void putShort (String key, 
                short value)

Inserts a short value into the mapping of this Bundle, replacing any existing value for the given key.

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

putShortArray

added in API level 1

void putShortArray (String key, 
                short[] value)

Inserts a short array 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`	`short`: a short array object, or null This value may be `null`.

putSize

added in API level 21

void putSize (String key, 
                Size value)

Inserts a Size 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`	`Size`: a Size object, or null This value may be `null`.

putSizeF

added in API level 21

void putSizeF (String key, 
                SizeF value)

Inserts a SizeF 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`	`SizeF`: a SizeF object, or null This value may be `null`.

putSparseParcelableArray

added in API level 1

void putSparseParcelableArray (String key, 
                SparseArray<? extends Parcelable> value)

Inserts a SparceArray of Parcelable values 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`	`SparseArray`: a SparseArray of Parcelable objects, or null This value may be `null`.

putStringArrayList

added in API level 1

void putStringArrayList (String key, 
                ArrayList<String> value)

Inserts an ArrayList 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`	`ArrayList`: an ArrayList object, or null This value may be `null`.

readFromParcel

added in API level 1

void readFromParcel (Parcel parcel)

Reads the Parcel contents into this Bundle, typically in order for it to be passed through an IBinder connection.

Parameters
`parcel`	`Parcel`: The parcel to overwrite this bundle from.

remove

added in API level 1

void remove (String key)

Removes any entry with the given key from the mapping of this Bundle.

Parameters
`key`	`String`: a String key

setClassLoader

added in API level 1

void setClassLoader (ClassLoader loader)

Changes the ClassLoader this Bundle uses when instantiating objects.

Parameters
`loader`	`ClassLoader`: An explicit ClassLoader to use when instantiating objects inside of the Bundle.

toString

added in API level 1

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 1

void writeToParcel (Parcel parcel, 
                int flags)

Writes the Bundle 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`.

Jun	JUL	Aug
	08
2016	2017	2018

Bundle

Summary

Inherited constants

Fields

Public constructors

Public methods

Inherited methods

Fields

CREATOR

EMPTY

Public constructors

Bundle

Bundle

Bundle

Bundle

Bundle

Public methods

clear

clone

deepCopy

describeContents

getBinder

getBundle

getByte

getByte

getByteArray

getChar

getChar

getCharArray

getCharSequence

getCharSequence

getCharSequenceArray

getCharSequenceArrayList

getClassLoader

getFloat

getFloat

getFloatArray

getIntegerArrayList

getParcelable

getParcelableArray

getParcelableArrayList

getSerializable

getShort

getShort

getShortArray

getSize

getSizeF

getSparseParcelableArray

getStringArrayList

hasFileDescriptors

putAll

putBinder

putBundle

putByte

putByteArray

putChar

putCharArray

putCharSequence

putCharSequenceArray

putCharSequenceArrayList

putFloat

putFloatArray

putIntegerArrayList

putParcelable

putParcelableArray

putParcelableArrayList

putSerializable

putShort

putShortArray

putSize

putSizeF

putSparseParcelableArray

putStringArrayList

readFromParcel

remove

setClassLoader

toString

writeToParcel

Interfaces

Classes