Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Fields](https://developer.android.com/reference/android/os/Parcel#lfields) \| [Methods](https://developer.android.com/reference/android/os/Parcel#pubmethods) \| [Protected Methods](https://developer.android.com/reference/android/os/Parcel#promethods) \| [Inherited Methods](https://developer.android.com/reference/android/os/Parcel#inhmethods)
# Parcel
*** ** * ** ***
` public final class Parcel `
` extends https://developer.android.com/reference/java/lang/Object ` ` `
|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.os.Parcel |
*** ** * ** ***
Container for a message (data and object references) that can be sent through an IBinder. A Parcel can contain both flattened data that will be unflattened on the other side of the IPC (using the various methods here for writing specific types, or the general `https://developer.android.com/reference/android/os/Parcelable` interface), and references to live `https://developer.android.com/reference/android/os/IBinder` objects that will result in the other side receiving a proxy IBinder connected with the original IBinder in the Parcel.
Parcel is **not** a general-purpose serialization mechanism. This class (and the corresponding `https://developer.android.com/reference/android/os/Parcelable` API for placing arbitrary objects into a Parcel) is designed as a high-performance IPC transport. As such, it is not appropriate to place any Parcel data in to persistent storage: changes in the underlying implementation of any of the data in the Parcel can render older data unreadable.
The bulk of the Parcel API revolves around reading and writing data of various types. There are six major classes of such functions available.
### Primitives
The most basic data functions are for writing and reading primitive data types: `https://developer.android.com/reference/android/os/Parcel#writeByte(byte)`, `https://developer.android.com/reference/android/os/Parcel#readByte()`, `https://developer.android.com/reference/android/os/Parcel#writeDouble(double)`, `https://developer.android.com/reference/android/os/Parcel#readDouble()`, `https://developer.android.com/reference/android/os/Parcel#writeFloat(float)`, `https://developer.android.com/reference/android/os/Parcel#readFloat()`, `https://developer.android.com/reference/android/os/Parcel#writeInt(int)`, `https://developer.android.com/reference/android/os/Parcel#readInt()`, `https://developer.android.com/reference/android/os/Parcel#writeLong(long)`, `https://developer.android.com/reference/android/os/Parcel#readLong()`, `https://developer.android.com/reference/android/os/Parcel#writeString(java.lang.String)`, `https://developer.android.com/reference/android/os/Parcel#readString()`. Most other data operations are built on top of these. The given data is written and read using the endianess of the host CPU.
### Primitive Arrays
There are a variety of methods for reading and writing raw arrays of primitive objects, which generally result in writing a 4-byte length followed by the primitive data items. The methods for reading can either read the data into an existing array, or create and return a new array. These available types are:
- `https://developer.android.com/reference/android/os/Parcel#writeBooleanArray(boolean[])`, `https://developer.android.com/reference/android/os/Parcel#readBooleanArray(boolean[])`, `https://developer.android.com/reference/android/os/Parcel#createBooleanArray()`
- `https://developer.android.com/reference/android/os/Parcel#writeByteArray(byte[])`, `https://developer.android.com/reference/android/os/Parcel#writeByteArray(byte[],%20int,%20int)`, `https://developer.android.com/reference/android/os/Parcel#readByteArray(byte[])`, `https://developer.android.com/reference/android/os/Parcel#createByteArray()`
- `https://developer.android.com/reference/android/os/Parcel#writeCharArray(char[])`, `https://developer.android.com/reference/android/os/Parcel#readCharArray(char[])`, `https://developer.android.com/reference/android/os/Parcel#createCharArray()`
- `https://developer.android.com/reference/android/os/Parcel#writeDoubleArray(double[])`, `https://developer.android.com/reference/android/os/Parcel#readDoubleArray(double[])`, `https://developer.android.com/reference/android/os/Parcel#createDoubleArray()`
- `https://developer.android.com/reference/android/os/Parcel#writeFloatArray(float[])`, `https://developer.android.com/reference/android/os/Parcel#readFloatArray(float[])`, `https://developer.android.com/reference/android/os/Parcel#createFloatArray()`
- `https://developer.android.com/reference/android/os/Parcel#writeIntArray(int[])`, `https://developer.android.com/reference/android/os/Parcel#readIntArray(int[])`, `https://developer.android.com/reference/android/os/Parcel#createIntArray()`
- `https://developer.android.com/reference/android/os/Parcel#writeLongArray(long[])`, `https://developer.android.com/reference/android/os/Parcel#readLongArray(long[])`, `https://developer.android.com/reference/android/os/Parcel#createLongArray()`
- `https://developer.android.com/reference/android/os/Parcel#writeStringArray(java.lang.String[])`, `https://developer.android.com/reference/android/os/Parcel#readStringArray(java.lang.String[])`, `https://developer.android.com/reference/android/os/Parcel#createStringArray()`.
- `https://developer.android.com/reference/android/os/Parcel#writeSparseBooleanArray(android.util.SparseBooleanArray)`, `https://developer.android.com/reference/android/os/Parcel#readSparseBooleanArray()`.
### Parcelables
The `https://developer.android.com/reference/android/os/Parcelable` protocol provides an extremely efficient (but low-level) protocol for objects to write and read themselves from Parcels. You can use the direct methods `https://developer.android.com/reference/android/os/Parcel#writeParcelable(android.os.Parcelable,%20int)` and `https://developer.android.com/reference/android/os/Parcel#readParcelable(java.lang.ClassLoader)` or `https://developer.android.com/reference/android/os/Parcel#writeParcelableArray(T[],%20int)` and `https://developer.android.com/reference/android/os/Parcel#readParcelableArray(java.lang.ClassLoader)` to write or read. These methods write both the class type and its data to the Parcel, allowing that class to be reconstructed from the appropriate class loader when later reading.
There are also some methods that provide a more efficient way to work with Parcelables: `https://developer.android.com/reference/android/os/Parcel#writeTypedObject(T,%20int)`, `https://developer.android.com/reference/android/os/Parcel#writeTypedArray(T[],%20int)`, `https://developer.android.com/reference/android/os/Parcel#writeTypedList(java.util.List)`, `https://developer.android.com/reference/android/os/Parcel#readTypedObject(android.os.Parcelable.Creator)`, `https://developer.android.com/reference/android/os/Parcel#createTypedArray(android.os.Parcelable.Creator)` and `https://developer.android.com/reference/android/os/Parcel#createTypedArrayList(android.os.Parcelable.Creator)`. These methods do not write the class information of the original object: instead, the caller of the read function must know what type to expect and pass in the appropriate `https://developer.android.com/reference/android/os/Parcelable.Creator` instead to properly construct the new object and read its data. (To more efficient write and read a single Parcelable object that is not null, you can directly call `https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)` and `https://developer.android.com/reference/android/os/Parcelable.Creator#createFromParcel(android.os.Parcel)` yourself.)
### Bundles
A special type-safe container, called `https://developer.android.com/reference/android/os/Bundle`, is available for key/value maps of heterogeneous values. This has many optimizations for improved performance when reading and writing data, and its type-safe API avoids difficult to debug type errors when finally marshalling the data contents into a Parcel. The methods to use are `https://developer.android.com/reference/android/os/Parcel#writeBundle(android.os.Bundle)`, `https://developer.android.com/reference/android/os/Parcel#readBundle()`, and `https://developer.android.com/reference/android/os/Parcel#readBundle(java.lang.ClassLoader)`.
### Active Objects
An unusual feature of Parcel is the ability to read and write active objects. For these objects the actual contents of the object is not written, rather a special token referencing the object is written. When reading the object back from the Parcel, you do not get a new instance of the object, but rather a handle that operates on the exact same object that was originally written. There are two forms of active objects available.
`https://developer.android.com/reference/android/os/Binder` objects are a core facility of Android's general cross-process communication system. The `https://developer.android.com/reference/android/os/IBinder` interface describes an abstract protocol with a Binder object. Any such interface can be written in to a Parcel, and upon reading you will receive either the original object implementing that interface or a special proxy implementation that communicates calls back to the original object. The methods to use are `https://developer.android.com/reference/android/os/Parcel#writeStrongBinder(android.os.IBinder)`, `https://developer.android.com/reference/android/os/Parcel#writeStrongInterface(android.os.IInterface)`, `https://developer.android.com/reference/android/os/Parcel#readStrongBinder()`, `https://developer.android.com/reference/android/os/Parcel#writeBinderArray(android.os.IBinder[])`, `https://developer.android.com/reference/android/os/Parcel#readBinderArray(android.os.IBinder[])`, `https://developer.android.com/reference/android/os/Parcel#createBinderArray()`, `https://developer.android.com/reference/android/os/Parcel#writeInterfaceArray(T[])`, `https://developer.android.com/reference/android/os/Parcel#readInterfaceArray(T[],%20java.util.function.Function)`, `https://developer.android.com/reference/android/os/Parcel#createInterfaceArray(java.util.function.IntFunction,%20java.util.function.Function)`, `https://developer.android.com/reference/android/os/Parcel#writeBinderList(java.util.List)`, `https://developer.android.com/reference/android/os/Parcel#readBinderList(java.util.List)`, `https://developer.android.com/reference/android/os/Parcel#createBinderArrayList()`, `https://developer.android.com/reference/android/os/Parcel#writeInterfaceList(java.util.List)`, `https://developer.android.com/reference/android/os/Parcel#readInterfaceList(java.util.List,%20java.util.function.Function)`, `https://developer.android.com/reference/android/os/Parcel#createInterfaceArrayList(java.util.function.Function)`.
FileDescriptor objects, representing raw Linux file descriptor identifiers, can be written and `https://developer.android.com/reference/android/os/ParcelFileDescriptor` objects returned to operate on the original file descriptor. The returned file descriptor is a dup of the original file descriptor: the object and fd is different, but operating on the same underlying file stream, with the same position, etc. The methods to use are `https://developer.android.com/reference/android/os/Parcel#writeFileDescriptor(java.io.FileDescriptor)`, `https://developer.android.com/reference/android/os/Parcel#readFileDescriptor()`.
### Parcelable Containers
A final class of methods are for writing and reading standard Java containers of arbitrary types. These all revolve around the `https://developer.android.com/reference/android/os/Parcel#writeValue(java.lang.Object)` and `https://developer.android.com/reference/android/os/Parcel#readValue(java.lang.ClassLoader)` methods which define the types of objects allowed. The container methods are `https://developer.android.com/reference/android/os/Parcel#writeArray(java.lang.Object[])`, `https://developer.android.com/reference/android/os/Parcel#readArray(java.lang.ClassLoader)`, `https://developer.android.com/reference/android/os/Parcel#writeList(java.util.List)`, `https://developer.android.com/reference/android/os/Parcel#readList(java.util.List,%20java.lang.ClassLoader)`, `https://developer.android.com/reference/android/os/Parcel#readArrayList(java.lang.ClassLoader)`, `https://developer.android.com/reference/android/os/Parcel#writeMap(java.util.Map)`, `https://developer.android.com/reference/android/os/Parcel#readMap(java.util.Map,%20java.lang.ClassLoader)`, `https://developer.android.com/reference/android/os/Parcel#writeSparseArray(android.util.SparseArray)`, `https://developer.android.com/reference/android/os/Parcel#readSparseArray(java.lang.ClassLoader)`.
### Restricted Parcelable Containers
A final class of methods are for reading standard Java containers of restricted types. These methods replace methods for reading containers of arbitrary types from previous section starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`. The pairing writing methods are still the same from previous section. These methods accepts additional `clazz` parameters as the required types. The Restricted Parcelable container methods are `https://developer.android.com/reference/android/os/Parcel#readArray(java.lang.ClassLoader,%20java.lang.Class)`, `https://developer.android.com/reference/android/os/Parcel#readList(java.util.List,%20java.lang.ClassLoader,%20java.lang.Class)`, `https://developer.android.com/reference/android/os/Parcel#readArrayList(java.lang.ClassLoader,%20java.lang.Class)`, `https://developer.android.com/reference/android/os/Parcel#readMap(java.util.Map,%20java.lang.ClassLoader,%20java.lang.Class,%20java.lang.Class)`, `https://developer.android.com/reference/android/os/Parcel#readSparseArray(java.lang.ClassLoader,%20java.lang.Class)`.
## Summary
| ### Fields ||
|---|---|
| ` public static final https://developer.android.com/reference/android/os/Parcelable.Creator` | `https://developer.android.com/reference/android/os/Parcel#STRING_CREATOR`
|
| ### Public methods ||
|---|---|
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#appendFrom(android.os.Parcel,%20int,%20int)(https://developer.android.com/reference/android/os/Parcel parcel, int offset, int length) ` |
| ` https://developer.android.com/reference/android/os/IBinder` | ` https://developer.android.com/reference/android/os/Parcel#createBinderArray()() ` |
| ` https://developer.android.com/reference/java/util/ArrayList` | ` https://developer.android.com/reference/android/os/Parcel#createBinderArrayList()() ` Read and return a new ArrayList containing IBinder objects from the parcel that was written with `https://developer.android.com/reference/android/os/Parcel#writeBinderList(java.util.List)` at the current dataPosition(). |
| ` boolean[]` | ` https://developer.android.com/reference/android/os/Parcel#createBooleanArray()() ` |
| ` byte[]` | ` https://developer.android.com/reference/android/os/Parcel#createByteArray()() ` Read and return a byte\[\] object from the parcel. |
| ` char[]` | ` https://developer.android.com/reference/android/os/Parcel#createCharArray()() ` |
| ` double[]` | ` https://developer.android.com/reference/android/os/Parcel#createDoubleArray()() ` |
| ` T` | ` https://developer.android.com/reference/android/os/Parcel#createFixedArray(java.lang.Class,%20java.util.function.Function,%20int[])(https://developer.android.com/reference/java/lang/Class cls, https://developer.android.com/reference/java/util/function/Function asInterface, int... dimensions) ` Read and return a new multi-dimensional array of typed interfaces from a parcel. |
| ` T` | ` https://developer.android.com/reference/android/os/Parcel#createFixedArray(java.lang.Class,%20android.os.Parcelable.Creator,%20int[])(https://developer.android.com/reference/java/lang/Class cls, https://developer.android.com/reference/android/os/Parcelable.Creator c, int... dimensions) ` Read and return a new multi-dimensional array of typed parcelables from a parcel. |
| ` T` | ` https://developer.android.com/reference/android/os/Parcel#createFixedArray(java.lang.Class,%20int[])(https://developer.android.com/reference/java/lang/Class cls, int... dimensions) ` Read and return a new multi-dimensional array from a parcel. |
| ` float[]` | ` https://developer.android.com/reference/android/os/Parcel#createFloatArray()() ` |
| ` int[]` | ` https://developer.android.com/reference/android/os/Parcel#createIntArray()() ` |
| ` T[]` | ` https://developer.android.com/reference/android/os/Parcel#createInterfaceArray(java.util.function.IntFunction,%20java.util.function.Function)(https://developer.android.com/reference/java/util/function/IntFunction newArray, https://developer.android.com/reference/java/util/function/Function asInterface) ` Read and return a new array of T (IInterface) from the parcel. |
| ` https://developer.android.com/reference/java/util/ArrayList` | ` https://developer.android.com/reference/android/os/Parcel#createInterfaceArrayList(java.util.function.Function)(https://developer.android.com/reference/java/util/function/Function asInterface) ` Read and return a new ArrayList containing T (IInterface) objects from the parcel that was written with `https://developer.android.com/reference/android/os/Parcel#writeInterfaceList(java.util.List)` at the current dataPosition(). |
| ` long[]` | ` https://developer.android.com/reference/android/os/Parcel#createLongArray()() ` |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/os/Parcel#createStringArray()() ` |
| ` https://developer.android.com/reference/java/util/ArrayList` | ` https://developer.android.com/reference/android/os/Parcel#createStringArrayList()() ` Read and return a new ArrayList containing String objects from the parcel that was written with `https://developer.android.com/reference/android/os/Parcel#writeStringList(java.util.List)` at the current dataPosition(). |
| ` T[]` | ` https://developer.android.com/reference/android/os/Parcel#createTypedArray(android.os.Parcelable.Creator)(https://developer.android.com/reference/android/os/Parcelable.Creator c) ` Read and return a new array containing a particular object type from the parcel at the current dataPosition(). |
| ` https://developer.android.com/reference/java/util/ArrayList` | ` https://developer.android.com/reference/android/os/Parcel#createTypedArrayList(android.os.Parcelable.Creator)(https://developer.android.com/reference/android/os/Parcelable.Creator c) ` Read and return a new ArrayList containing a particular object type from the parcel that was written with `https://developer.android.com/reference/android/os/Parcel#writeTypedList(java.util.List)` at the current dataPosition(). |
| ` https://developer.android.com/reference/android/util/ArrayMap` | ` https://developer.android.com/reference/android/os/Parcel#createTypedArrayMap(android.os.Parcelable.Creator)(https://developer.android.com/reference/android/os/Parcelable.Creator creator) ` Read into a new `https://developer.android.com/reference/android/util/ArrayMap` with string keys items containing a particular object type that were written with `https://developer.android.com/reference/android/os/Parcel#writeTypedArrayMap(android.util.ArrayMap,%20int)` at the current dataPosition(). |
| ` https://developer.android.com/reference/android/util/SparseArray` | ` https://developer.android.com/reference/android/os/Parcel#createTypedSparseArray(android.os.Parcelable.Creator)(https://developer.android.com/reference/android/os/Parcelable.Creator creator) ` Read into a new `https://developer.android.com/reference/android/util/SparseArray` items containing a particular object type that were written with `https://developer.android.com/reference/android/os/Parcel#writeTypedSparseArray(android.util.SparseArray,%20int)` at the current dataPosition(). |
| ` int` | ` https://developer.android.com/reference/android/os/Parcel#dataAvail()() ` Returns the amount of data remaining to be read from the parcel. |
| ` int` | ` https://developer.android.com/reference/android/os/Parcel#dataCapacity()() ` Returns the total amount of space in the parcel. |
| ` int` | ` https://developer.android.com/reference/android/os/Parcel#dataPosition()() ` Returns the current position in the parcel data. |
| ` int` | ` https://developer.android.com/reference/android/os/Parcel#dataSize()() ` Returns the total amount of data contained in the parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#enforceInterface(java.lang.String)(https://developer.android.com/reference/java/lang/String interfaceName) ` Read the header written by writeInterfaceToken and verify it matches the interface name in question. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#enforceNoDataAvail()() ` Verify there are no bytes left to be read on the Parcel. |
| ` boolean` | ` https://developer.android.com/reference/android/os/Parcel#hasFileDescriptors()() ` Report whether the parcel contains any marshalled file descriptors. |
| ` boolean` | ` https://developer.android.com/reference/android/os/Parcel#hasFileDescriptors(int,%20int)(int offset, int length) ` Report whether the parcel contains any marshalled file descriptors in the range defined by `offset` and `length`. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#marshall(java.nio.ByteBuffer)(https://developer.android.com/reference/java/nio/ByteBuffer buffer) ` Writes the raw bytes of the parcel to a buffer. |
| ` byte[]` | ` https://developer.android.com/reference/android/os/Parcel#marshall()() ` Returns the raw bytes of the parcel. |
| ` static https://developer.android.com/reference/android/os/Parcel` | ` https://developer.android.com/reference/android/os/Parcel#obtain()() ` Retrieve a new Parcel object from the pool. |
| ` static https://developer.android.com/reference/android/os/Parcel` | ` https://developer.android.com/reference/android/os/Parcel#obtain(android.os.IBinder)(https://developer.android.com/reference/android/os/IBinder binder) ` Retrieve a new Parcel object from the pool for use with a specific binder. |
| ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/android/os/Parcel#readArray(java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/ClassLoader loader) ` *This method was deprecated in API level 33. Use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readArray(java.lang.ClassLoader,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`. Also consider changing the format to use `https://developer.android.com/reference/android/os/Parcel#createTypedArray(android.os.Parcelable.Creator)` if possible (eg. if the items' class is final) since this is also more performant. Note that changing to the latter also requires changing the writes.* |
| ` T[]` | ` https://developer.android.com/reference/android/os/Parcel#readArray(java.lang.ClassLoader,%20java.lang.Class)(https://developer.android.com/reference/java/lang/ClassLoader loader, https://developer.android.com/reference/java/lang/Class clazz) ` Same as `https://developer.android.com/reference/android/os/Parcel#readArray(java.lang.ClassLoader)` but accepts `clazz` parameter as the type required for each item. |
| ` https://developer.android.com/reference/java/util/ArrayList` | ` https://developer.android.com/reference/android/os/Parcel#readArrayList(java.lang.ClassLoader,%20java.lang.Class)(https://developer.android.com/reference/java/lang/ClassLoader loader, https://developer.android.com/reference/java/lang/Class clazz) ` Same as `https://developer.android.com/reference/android/os/Parcel#readArrayList(java.lang.ClassLoader)` but accepts `clazz` parameter as the type required for each item. |
| ` https://developer.android.com/reference/java/util/ArrayList` | ` https://developer.android.com/reference/android/os/Parcel#readArrayList(java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/ClassLoader loader) ` *This method was deprecated in API level 33. Use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readArrayList(java.lang.ClassLoader,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`. Also consider changing the format to use `https://developer.android.com/reference/android/os/Parcel#createTypedArrayList(android.os.Parcelable.Creator)` if possible (eg. if the items' class is final) since this is also more performant. Note that changing to the latter also requires changing the writes.* |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readBinderArray(android.os.IBinder[])(https://developer.android.com/reference/android/os/IBinder val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readBinderList(java.util.List)(https://developer.android.com/reference/java/util/List list) ` Read into the given List items IBinder objects that were written with `https://developer.android.com/reference/android/os/Parcel#writeBinderList(java.util.List)` at the current dataPosition(). |
| ` byte[]` | ` https://developer.android.com/reference/android/os/Parcel#readBlob()() ` Read a blob of data from the parcel and return it as a byte array. |
| ` boolean` | ` https://developer.android.com/reference/android/os/Parcel#readBoolean()() ` Read a boolean value from the parcel at the current dataPosition(). |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readBooleanArray(boolean[])(boolean[] val) ` |
| ` https://developer.android.com/reference/android/os/Bundle` | ` https://developer.android.com/reference/android/os/Parcel#readBundle()() ` Read and return a new Bundle object from the parcel at the current dataPosition(). |
| ` https://developer.android.com/reference/android/os/Bundle` | ` https://developer.android.com/reference/android/os/Parcel#readBundle(java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/ClassLoader loader) ` Read and return a new Bundle object from the parcel at the current dataPosition(), using the given class loader to initialize the class loader of the Bundle for later retrieval of Parcelable objects. |
| ` byte` | ` https://developer.android.com/reference/android/os/Parcel#readByte()() ` Read a byte value from the parcel at the current dataPosition(). |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readByteArray(byte[])(byte[] val) ` Read a byte\[\] object from the parcel and copy it into the given byte array. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readCharArray(char[])(char[] val) ` |
| ` double` | ` https://developer.android.com/reference/android/os/Parcel#readDouble()() ` Read a double precision floating point value from the parcel at the current dataPosition(). |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readDoubleArray(double[])(double[] val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readException()() ` Special function for reading an exception result from the header of a parcel, to be used after receiving the result of a transaction. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readException(int,%20java.lang.String)(int code, https://developer.android.com/reference/java/lang/String msg) ` Throw an exception with the given message. |
| ` https://developer.android.com/reference/android/os/ParcelFileDescriptor` | ` https://developer.android.com/reference/android/os/Parcel#readFileDescriptor()() ` Read a FileDescriptor from the parcel at the current dataPosition(). |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readFixedArray(T,%20android.os.Parcelable.Creator)(T val, https://developer.android.com/reference/android/os/Parcelable.Creator c) ` Read a new multi-dimensional array of typed parcelables from a parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readFixedArray(T,%20java.util.function.Function)(T val, https://developer.android.com/reference/java/util/function/Function asInterface) ` Read a new multi-dimensional array of typed interfaces from a parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readFixedArray(T)(T val) ` Read a new multi-dimensional array from a parcel. |
| ` float` | ` https://developer.android.com/reference/android/os/Parcel#readFloat()() ` Read a floating point value from the parcel at the current dataPosition(). |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readFloatArray(float[])(float[] val) ` |
| ` https://developer.android.com/reference/java/util/HashMap` | ` https://developer.android.com/reference/android/os/Parcel#readHashMap(java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/ClassLoader loader) ` *This method was deprecated in API level 33. Consider using `https://developer.android.com/reference/android/os/Parcel#readBundle(java.lang.ClassLoader)` as stated above, in case this method is still preferred use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readHashMap(java.lang.ClassLoader,%20java.lang.Class,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`.* |
| ` https://developer.android.com/reference/java/util/HashMap` | ` https://developer.android.com/reference/android/os/Parcel#readHashMap(java.lang.ClassLoader,%20java.lang.Class,%20java.lang.Class)(https://developer.android.com/reference/java/lang/ClassLoader loader, https://developer.android.com/reference/java/lang/Class clazzKey, https://developer.android.com/reference/java/lang/Class clazzValue) ` Same as `https://developer.android.com/reference/android/os/Parcel#readHashMap(java.lang.ClassLoader)` but accepts `clazzKey` and `clazzValue` parameter as the types required for each key and value pair. |
| ` int` | ` https://developer.android.com/reference/android/os/Parcel#readInt()() ` Read an integer value from the parcel at the current dataPosition(). |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readIntArray(int[])(int[] val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readInterfaceArray(T[],%20java.util.function.Function)(T[] val, https://developer.android.com/reference/java/util/function/Function asInterface) ` Read an array of T (IInterface) from a parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readInterfaceList(java.util.List,%20java.util.function.Function)(https://developer.android.com/reference/java/util/List list, https://developer.android.com/reference/java/util/function/Function asInterface) ` Read into the given List items IInterface objects that were written with `https://developer.android.com/reference/android/os/Parcel#writeInterfaceList(java.util.List)` at the current dataPosition(). |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readList(java.util.List,%20java.lang.ClassLoader)(https://developer.android.com/reference/java/util/List outVal, https://developer.android.com/reference/java/lang/ClassLoader loader) ` *This method was deprecated in API level 33. Use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readList(java.util.List,%20java.lang.ClassLoader,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`. Also consider changing the format to use `https://developer.android.com/reference/android/os/Parcel#readTypedList(java.util.List,%20android.os.Parcelable.Creator)` if possible (eg. if the items' class is final) since this is also more performant. Note that changing to the latter also requires changing the writes.* |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readList(java.util.List,%20java.lang.ClassLoader,%20java.lang.Class)(https://developer.android.com/reference/java/util/List outVal, https://developer.android.com/reference/java/lang/ClassLoader loader, https://developer.android.com/reference/java/lang/Class clazz) ` Same as `https://developer.android.com/reference/android/os/Parcel#readList(java.util.List,%20java.lang.ClassLoader)` but accepts `clazz` parameter as the type required for each item. |
| ` long` | ` https://developer.android.com/reference/android/os/Parcel#readLong()() ` Read a long integer value from the parcel at the current dataPosition(). |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readLongArray(long[])(long[] val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readMap(java.util.Map,%20java.lang.ClassLoader)(https://developer.android.com/reference/java/util/Map outVal, https://developer.android.com/reference/java/lang/ClassLoader loader) ` *This method was deprecated in API level 33. Consider using `https://developer.android.com/reference/android/os/Parcel#readBundle(java.lang.ClassLoader)` as stated above, in case this method is still preferred use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readMap(java.util.Map,%20java.lang.ClassLoader,%20java.lang.Class,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`.* |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readMap(java.util.Map,%20java.lang.ClassLoader,%20java.lang.Class,%20java.lang.Class)(https://developer.android.com/reference/java/util/Map outVal, https://developer.android.com/reference/java/lang/ClassLoader loader, https://developer.android.com/reference/java/lang/Class clazzKey, https://developer.android.com/reference/java/lang/Class clazzValue) ` Same as `https://developer.android.com/reference/android/os/Parcel#readMap(java.util.Map,%20java.lang.ClassLoader)` but accepts `clazzKey` and `clazzValue` parameter as the types required for each key and value pair. |
| ` T` | ` https://developer.android.com/reference/android/os/Parcel#readParcelable(java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/ClassLoader loader) ` *This method was deprecated in API level 33. Use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readParcelable(java.lang.ClassLoader,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`. Also consider changing the format to use `https://developer.android.com/reference/android/os/Parcelable.Creator#createFromParcel(android.os.Parcel)` if possible since this is also more performant. Note that changing to the latter also requires changing the writes.* |
| ` T` | ` https://developer.android.com/reference/android/os/Parcel#readParcelable(java.lang.ClassLoader,%20java.lang.Class)(https://developer.android.com/reference/java/lang/ClassLoader loader, https://developer.android.com/reference/java/lang/Class clazz) ` Same as `https://developer.android.com/reference/android/os/Parcel#readParcelable(java.lang.ClassLoader)` but accepts `clazz` parameter as the type required for each item. |
| ` T[]` | ` https://developer.android.com/reference/android/os/Parcel#readParcelableArray(java.lang.ClassLoader,%20java.lang.Class)(https://developer.android.com/reference/java/lang/ClassLoader loader, https://developer.android.com/reference/java/lang/Class clazz) ` Same as `https://developer.android.com/reference/android/os/Parcel#readParcelableArray(java.lang.ClassLoader)` but accepts `clazz` parameter as the type required for each item. |
| ` https://developer.android.com/reference/android/os/Parcelable` | ` https://developer.android.com/reference/android/os/Parcel#readParcelableArray(java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/ClassLoader loader) ` *This method was deprecated in API level 33. Use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readParcelableArray(java.lang.ClassLoader,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`. Also consider changing the format to use `https://developer.android.com/reference/android/os/Parcel#createTypedArray(android.os.Parcelable.Creator)` if possible (eg. if the items' class is final) since this is also more performant. Note that changing to the latter also requires changing the writes.* |
| ` https://developer.android.com/reference/android/os/Parcelable.Creator` | ` https://developer.android.com/reference/android/os/Parcel#readParcelableCreator(java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/ClassLoader loader) ` *This method was deprecated in API level 33. Use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readParcelableCreator(java.lang.ClassLoader,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`.* |
| ` https://developer.android.com/reference/android/os/Parcelable.Creator` | ` https://developer.android.com/reference/android/os/Parcel#readParcelableCreator(java.lang.ClassLoader,%20java.lang.Class)(https://developer.android.com/reference/java/lang/ClassLoader loader, https://developer.android.com/reference/java/lang/Class clazz) ` Same as `https://developer.android.com/reference/android/os/Parcel#readParcelableCreator(java.lang.ClassLoader)` but accepts `clazz` parameter as the required type. |
| ` https://developer.android.com/reference/java/util/List` | ` https://developer.android.com/reference/android/os/Parcel#readParcelableList(java.util.List,%20java.lang.ClassLoader,%20java.lang.Class)(https://developer.android.com/reference/java/util/List list, https://developer.android.com/reference/java/lang/ClassLoader cl, https://developer.android.com/reference/java/lang/Class clazz) ` Same as `https://developer.android.com/reference/android/os/Parcel#readParcelableList(java.util.List,%20java.lang.ClassLoader)` but accepts `clazz` parameter as the type required for each item. |
| ` https://developer.android.com/reference/java/util/List` | ` https://developer.android.com/reference/android/os/Parcel#readParcelableList(java.util.List,%20java.lang.ClassLoader)(https://developer.android.com/reference/java/util/List list, https://developer.android.com/reference/java/lang/ClassLoader cl) ` *This method was deprecated in API level 33. Use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readParcelableList(java.util.List,%20java.lang.ClassLoader,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`. Also consider changing the format to use `https://developer.android.com/reference/android/os/Parcel#readTypedList(java.util.List,%20android.os.Parcelable.Creator)` if possible (eg. if the items' class is final) since this is also more performant. Note that changing to the latter also requires changing the writes.* |
| ` https://developer.android.com/reference/android/os/PersistableBundle` | ` https://developer.android.com/reference/android/os/Parcel#readPersistableBundle()() ` Read and return a new Bundle object from the parcel at the current dataPosition(). |
| ` https://developer.android.com/reference/android/os/PersistableBundle` | ` https://developer.android.com/reference/android/os/Parcel#readPersistableBundle(java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/ClassLoader loader) ` Read and return a new Bundle object from the parcel at the current dataPosition(), using the given class loader to initialize the class loader of the Bundle for later retrieval of Parcelable objects. |
| ` https://developer.android.com/reference/java/io/Serializable` | ` https://developer.android.com/reference/android/os/Parcel#readSerializable()() ` *This method was deprecated in API level 33. Use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readSerializable(java.lang.ClassLoader,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`.* |
| ` T` | ` https://developer.android.com/reference/android/os/Parcel#readSerializable(java.lang.ClassLoader,%20java.lang.Class)(https://developer.android.com/reference/java/lang/ClassLoader loader, https://developer.android.com/reference/java/lang/Class clazz) ` Same as `https://developer.android.com/reference/android/os/Parcel#readSerializable()` but accepts `loader` and `clazz` parameters. |
| ` https://developer.android.com/reference/android/util/Size` | ` https://developer.android.com/reference/android/os/Parcel#readSize()() ` Read a Size from the parcel at the current dataPosition(). |
| ` https://developer.android.com/reference/android/util/SizeF` | ` https://developer.android.com/reference/android/os/Parcel#readSizeF()() ` Read a SizeF from the parcel at the current dataPosition(). |
| ` https://developer.android.com/reference/android/util/SparseArray` | ` https://developer.android.com/reference/android/os/Parcel#readSparseArray(java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/ClassLoader loader) ` *This method was deprecated in API level 33. Use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readSparseArray(java.lang.ClassLoader,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`. Also consider changing the format to use `https://developer.android.com/reference/android/os/Parcel#createTypedSparseArray(android.os.Parcelable.Creator)` if possible (eg. if the items' class is final) since this is also more performant. Note that changing to the latter also requires changing the writes.* |
| ` https://developer.android.com/reference/android/util/SparseArray` | ` https://developer.android.com/reference/android/os/Parcel#readSparseArray(java.lang.ClassLoader,%20java.lang.Class)(https://developer.android.com/reference/java/lang/ClassLoader loader, https://developer.android.com/reference/java/lang/Class clazz) ` Same as `https://developer.android.com/reference/android/os/Parcel#readSparseArray(java.lang.ClassLoader)` but accepts `clazz` parameter as the type required for each item. |
| ` https://developer.android.com/reference/android/util/SparseBooleanArray` | ` https://developer.android.com/reference/android/os/Parcel#readSparseBooleanArray()() ` Read and return a new SparseBooleanArray object from the parcel at the current dataPosition(). |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/os/Parcel#readString()() ` Read a string value from the parcel at the current dataPosition(). |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readStringArray(java.lang.String[])(https://developer.android.com/reference/java/lang/String val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readStringList(java.util.List)(https://developer.android.com/reference/java/util/List list) ` Read into the given List items String objects that were written with `https://developer.android.com/reference/android/os/Parcel#writeStringList(java.util.List)` at the current dataPosition(). |
| ` https://developer.android.com/reference/android/os/IBinder` | ` https://developer.android.com/reference/android/os/Parcel#readStrongBinder()() ` Read an object from the parcel at the current dataPosition(). |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readTypedArray(T[],%20android.os.Parcelable.Creator)(T[] val, https://developer.android.com/reference/android/os/Parcelable.Creator c) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#readTypedList(java.util.List,%20android.os.Parcelable.Creator)(https://developer.android.com/reference/java/util/List list, https://developer.android.com/reference/android/os/Parcelable.Creator c) ` Read into the given List items containing a particular object type that were written with `https://developer.android.com/reference/android/os/Parcel#writeTypedList(java.util.List)` at the current dataPosition(). |
| ` T` | ` https://developer.android.com/reference/android/os/Parcel#readTypedObject(android.os.Parcelable.Creator)(https://developer.android.com/reference/android/os/Parcelable.Creator c) ` Read and return a typed Parcelable object from a parcel. |
| ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/android/os/Parcel#readValue(java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/ClassLoader loader) ` Read a typed object from a parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#recycle()() ` Put a Parcel object back into the pool. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#setDataCapacity(int)(int size) ` Change the capacity (current available space) of the parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#setDataPosition(int)(int pos) ` Move the current read/write position in the parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#setDataSize(int)(int size) ` Change the amount of data in the parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#setPropagateAllowBlocking()() ` This method is used by the AIDL compiler for system components. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#unmarshall(byte[],%20int,%20int)(byte[] data, int offset, int length) ` Fills the raw bytes of this Parcel with the supplied data. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#unmarshall(java.nio.ByteBuffer)(https://developer.android.com/reference/java/nio/ByteBuffer buffer) ` Fills the raw bytes of this Parcel with data from the supplied buffer. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeArray(java.lang.Object[])(https://developer.android.com/reference/java/lang/Object val) ` Flatten an Object array into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeBinderArray(android.os.IBinder[])(https://developer.android.com/reference/android/os/IBinder val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeBinderList(java.util.List)(https://developer.android.com/reference/java/util/List val) ` Flatten a List containing IBinder objects into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeBlob(byte[])(byte[] b) ` Write a blob of data into the parcel at the current `https://developer.android.com/reference/android/os/Parcel#dataPosition()`, growing `https://developer.android.com/reference/android/os/Parcel#dataCapacity()` if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeBlob(byte[],%20int,%20int)(byte[] b, int offset, int len) ` Write a blob of data into the parcel at the current `https://developer.android.com/reference/android/os/Parcel#dataPosition()`, growing `https://developer.android.com/reference/android/os/Parcel#dataCapacity()` if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeBoolean(boolean)(boolean val) ` Write a boolean value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeBooleanArray(boolean[])(boolean[] val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeBundle(android.os.Bundle)(https://developer.android.com/reference/android/os/Bundle val) ` Flatten a Bundle into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeByte(byte)(byte val) ` Write a byte value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeByteArray(byte[])(byte[] b) ` Write a byte array into the parcel at the current `https://developer.android.com/reference/android/os/Parcel#dataPosition()`, growing `https://developer.android.com/reference/android/os/Parcel#dataCapacity()` if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeByteArray(byte[],%20int,%20int)(byte[] b, int offset, int len) ` Write a byte array into the parcel at the current `https://developer.android.com/reference/android/os/Parcel#dataPosition()`, growing `https://developer.android.com/reference/android/os/Parcel#dataCapacity()` if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeCharArray(char[])(char[] val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeDouble(double)(double val) ` Write a double precision floating point value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeDoubleArray(double[])(double[] val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeException(java.lang.Exception)(https://developer.android.com/reference/java/lang/Exception e) ` Special function for writing an exception result at the header of a parcel, to be used when returning an exception from a transaction. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeFileDescriptor(java.io.FileDescriptor)(https://developer.android.com/reference/java/io/FileDescriptor val) ` Write a FileDescriptor into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeFixedArray(T,%20int,%20int[])(T val, int parcelableFlags, int... dimensions) ` Flatten a homogeneous multi-dimensional array with fixed-size. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeFloat(float)(float val) ` Write a floating point value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeFloatArray(float[])(float[] val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeInt(int)(int val) ` Write an integer value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeIntArray(int[])(int[] val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeInterfaceArray(T[])(T[] val) ` Flatten a homogeneous array containing an IInterface type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeInterfaceList(java.util.List)(https://developer.android.com/reference/java/util/List val) ` Flatten a `List` containing T (IInterface) objects into this parcel at the current position. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeInterfaceToken(java.lang.String)(https://developer.android.com/reference/java/lang/String interfaceName) ` Store or read an IBinder interface token in the parcel at the current `https://developer.android.com/reference/android/os/Parcel#dataPosition()`. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeList(java.util.List)(https://developer.android.com/reference/java/util/List val) ` Flatten a List into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeLong(long)(long val) ` Write a long integer value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeLongArray(long[])(long[] val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeMap(java.util.Map)(https://developer.android.com/reference/java/util/Map val) ` Please use `https://developer.android.com/reference/android/os/Parcel#writeBundle(android.os.Bundle)` instead. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeNoException()() ` Special function for writing information at the front of the Parcel indicating that no exception occurred. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeParcelable(android.os.Parcelable,%20int)(https://developer.android.com/reference/android/os/Parcelable p, int parcelableFlags) ` Flatten the name of the class of the Parcelable and its contents into the parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeParcelableArray(T[],%20int)(T[] value, int parcelableFlags) ` Write a heterogeneous array of Parcelable objects into the Parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeParcelableCreator(android.os.Parcelable)(https://developer.android.com/reference/android/os/Parcelable p) ` Flatten the name of the class of the Parcelable into this Parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeParcelableList(java.util.List,%20int)(https://developer.android.com/reference/java/util/List val, int flags) ` Flatten a `List` containing arbitrary `Parcelable` objects into this parcel at the current position. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writePersistableBundle(android.os.PersistableBundle)(https://developer.android.com/reference/android/os/PersistableBundle val) ` Flatten a PersistableBundle into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeSerializable(java.io.Serializable)(https://developer.android.com/reference/java/io/Serializable s) ` Write a generic serializable object in to a Parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeSize(android.util.Size)(https://developer.android.com/reference/android/util/Size val) ` Flatten a Size into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeSizeF(android.util.SizeF)(https://developer.android.com/reference/android/util/SizeF val) ` Flatten a SizeF into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeSparseArray(android.util.SparseArray)(https://developer.android.com/reference/android/util/SparseArray val) ` Flatten a generic SparseArray into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeSparseBooleanArray(android.util.SparseBooleanArray)(https://developer.android.com/reference/android/util/SparseBooleanArray val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeString(java.lang.String)(https://developer.android.com/reference/java/lang/String val) ` Write a string value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeStringArray(java.lang.String[])(https://developer.android.com/reference/java/lang/String val) ` |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeStringList(java.util.List)(https://developer.android.com/reference/java/util/List val) ` Flatten a List containing String objects into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeStrongBinder(android.os.IBinder)(https://developer.android.com/reference/android/os/IBinder val) ` Write an object into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeStrongInterface(android.os.IInterface)(https://developer.android.com/reference/android/os/IInterface val) ` Write an object into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeTypedArray(T[],%20int)(T[] val, int parcelableFlags) ` Flatten a homogeneous array containing a particular object type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeTypedArrayMap(android.util.ArrayMap,%20int)(https://developer.android.com/reference/android/util/ArrayMap val, int parcelableFlags) ` Flatten an `https://developer.android.com/reference/android/util/ArrayMap` with string keys containing a particular object type into the parcel at the current dataPosition() and growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeTypedList(java.util.List,%20int)(https://developer.android.com/reference/java/util/List val, int parcelableFlags) ` Flatten a List containing a particular object type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeTypedList(java.util.List)(https://developer.android.com/reference/java/util/List val) ` Flatten a List containing a particular object type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeTypedObject(T,%20int)(T val, int parcelableFlags) ` Flatten the Parcelable object into the parcel. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeTypedSparseArray(android.util.SparseArray,%20int)(https://developer.android.com/reference/android/util/SparseArray val, int parcelableFlags) ` Flatten a `https://developer.android.com/reference/android/util/SparseArray` containing a particular object type into the parcel at the current dataPosition() and growing dataCapacity() if needed. |
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#writeValue(java.lang.Object)(https://developer.android.com/reference/java/lang/Object v) ` Flatten a generic object in to a parcel. |
| ### Protected methods ||
|---|---|
| ` void` | ` https://developer.android.com/reference/android/os/Parcel#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. |
### Inherited methods
From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `
Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `
Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `
Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class` ` https://developer.android.com/reference/java/lang/Object#getClass()() `
Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `
Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `
Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `
Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `
Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `
Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `
Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `
Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.
## Fields
### STRING_CREATOR
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final Creator STRING_CREATOR
```
## Public methods
### appendFrom
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void appendFrom (Parcel parcel,
int offset,
int length)
```
| Parameters ||
|---|---|
| `parcel` | `Parcel`
|
| `offset` | `int`
|
| `length` | `int`
|
### createBinderArray
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public IBinder[] createBinderArray ()
```
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/os/IBinder` | This value may be `null`.
|
### createBinderArrayList
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public ArrayList createBinderArrayList ()
```
Read and return a new ArrayList containing IBinder objects from the parcel that was written with `https://developer.android.com/reference/android/os/Parcel#writeBinderList(java.util.List)` at the current dataPosition(). Returns null if the previously written list object was null.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/ArrayList` | A newly created ArrayList containing strings with the same data as those that were previously written.
|
**See also:**
- `https://developer.android.com/reference/android/os/Parcel#writeBinderList(java.util.List)`
### createBooleanArray
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean[] createBooleanArray ()
```
| Returns ||
|---|---|
| `boolean[]` | This value may be `null`.
|
### createByteArray
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public byte[] createByteArray ()
```
Read and return a byte\[\] object from the parcel.
| Returns ||
|---|---|
| `byte[]` | This value may be `null`.
|
### createCharArray
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public char[] createCharArray ()
```
| Returns ||
|---|---|
| `char[]` | This value may be `null`.
|
### createDoubleArray
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public double[] createDoubleArray ()
```
| Returns ||
|---|---|
| `double[]` | This value may be `null`.
|
### createFixedArray
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public T createFixedArray (Class cls,
Function asInterface,
int... dimensions)
```
Read and return a new multi-dimensional array of typed interfaces from a parcel. Returns null if the previously written array object is null. If you want to read Parcelable values, use `https://developer.android.com/reference/android/os/Parcel#createFixedArray(java.lang.Class,%20android.os.Parcelable.Creator,%20int[])`. For values of other types use `https://developer.android.com/reference/android/os/Parcel#createFixedArray(java.lang.Class,%20int[])`.
| Parameters ||
|---|---|
| `cls` | `Class`: the Class object for the target array type. (e.g. IFoo\[\]\[\].class). This value cannot be `null`.
|
| `asInterface` | `Function`: This value cannot be `null`.
|
| `dimensions` | `int`: an array of int representing length of each dimension. This value cannot be `null`.
|
| Returns ||
|---|---|
| `T` |
|
### createFixedArray
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public T createFixedArray (Class cls,
Creator c,
int... dimensions)
```
Read and return a new multi-dimensional array of typed parcelables from a parcel. Returns null if the previously written array object is null. If you want to read IInterface values, use `https://developer.android.com/reference/android/os/Parcel#createFixedArray(java.lang.Class,%20java.util.function.Function,%20int[])`. For values of other types use `https://developer.android.com/reference/android/os/Parcel#createFixedArray(java.lang.Class,%20int[])`.
| Parameters ||
|---|---|
| `cls` | `Class`: the Class object for the target array type. (e.g. Foo\[\]\[\].class). This value cannot be `null`.
|
| `c` | `Creator`: This value cannot be `null`.
|
| `dimensions` | `int`: an array of int representing length of each dimension. This value cannot be `null`.
|
| Returns ||
|---|---|
| `T` |
|
### createFixedArray
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public T createFixedArray (Class cls,
int... dimensions)
```
Read and return a new multi-dimensional array from a parcel. Returns null if the previously written array object is null. If you want to read Parcelable or IInterface values, use `https://developer.android.com/reference/android/os/Parcel#createFixedArray(java.lang.Class,%20android.os.Parcelable.Creator,%20int[])` or `https://developer.android.com/reference/android/os/Parcel#createFixedArray(java.lang.Class,%20java.util.function.Function,%20int[])`.
| Parameters ||
|---|---|
| `cls` | `Class`: the Class object for the target array type. (e.g. int\[\]\[\].class). This value cannot be `null`.
|
| `dimensions` | `int`: an array of int representing length of each dimension. This value cannot be `null`.
|
| Returns ||
|---|---|
| `T` |
|
**See also:**
- `https://developer.android.com/reference/android/os/Parcel#writeTypedArray(T[],%20int)`
- `https://developer.android.com/reference/android/os/Parcel#createBooleanArray()`
- `https://developer.android.com/reference/android/os/Parcel#createByteArray()`
- `https://developer.android.com/reference/android/os/Parcel#createCharArray()`
- `https://developer.android.com/reference/android/os/Parcel#createIntArray()`
- `https://developer.android.com/reference/android/os/Parcel#createLongArray()`
- `https://developer.android.com/reference/android/os/Parcel#createFloatArray()`
- `https://developer.android.com/reference/android/os/Parcel#createDoubleArray()`
- `https://developer.android.com/reference/android/os/Parcel#createBinderArray()`
- `https://developer.android.com/reference/android/os/Parcel#createInterfaceArray(java.util.function.IntFunction,%20java.util.function.Function)`
- `https://developer.android.com/reference/android/os/Parcel#createTypedArray(android.os.Parcelable.Creator)`
### createFloatArray
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public float[] createFloatArray ()
```
| Returns ||
|---|---|
| `float[]` | This value may be `null`.
|
### createIntArray
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int[] createIntArray ()
```
| Returns ||
|---|---|
| `int[]` | This value may be `null`.
|
### createInterfaceArray
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public T[] createInterfaceArray (IntFunction newArray,
Function asInterface)
```
Read and return a new array of T (IInterface) from the parcel.
| Parameters ||
|---|---|
| `newArray` | `IntFunction`: a function to create an array of T with a given length. This value cannot be `null`.
|
| `asInterface` | `Function`: a function to convert IBinder object into T (IInterface). This value cannot be `null`.
|
| Returns ||
|---|---|
| `T[]` | the IInterface array of type T. This value may be `null`.
|
### createInterfaceArrayList
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public ArrayList createInterfaceArrayList (Function asInterface)
```
Read and return a new ArrayList containing T (IInterface) objects from the parcel that was written with `https://developer.android.com/reference/android/os/Parcel#writeInterfaceList(java.util.List)` at the current dataPosition(). Returns null if the previously written list object was null.
| Parameters ||
|---|---|
| `asInterface` | `Function`: This value cannot be `null`.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/ArrayList` | A newly created ArrayList containing T (IInterface)
|
**See also:**
- `https://developer.android.com/reference/android/os/Parcel#writeInterfaceList(java.util.List)`
### createLongArray
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public long[] createLongArray ()
```
| Returns ||
|---|---|
| `long[]` | This value may be `null`.
|
### createStringArray
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String[] createStringArray ()
```
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | This value may be `null`.
|
### createStringArrayList
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public ArrayList createStringArrayList ()
```
Read and return a new ArrayList containing String objects from the parcel that was written with `https://developer.android.com/reference/android/os/Parcel#writeStringList(java.util.List)` at the current dataPosition(). Returns null if the previously written list object was null.
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/ArrayList` | A newly created ArrayList containing strings with the same data as those that were previously written.
|
**See also:**
- `https://developer.android.com/reference/android/os/Parcel#writeStringList(java.util.List)`
### createTypedArray
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public T[] createTypedArray (Creator c)
```
Read and return a new array containing a particular object type from the parcel at the current dataPosition(). Returns null if the previously written array was null. The array *must* have previously been written via `https://developer.android.com/reference/android/os/Parcel#writeTypedArray(T[],%20int)` with the same object type.
| Parameters ||
|---|---|
| `c` | `Creator`: This value cannot be `null`.
|
| Returns ||
|---|---|
| `T[]` | A newly created array containing objects with the same data as those that were previously written.
|
**See also:**
- `https://developer.android.com/reference/android/os/Parcel#writeTypedArray(T[],%20int)`
### createTypedArrayList
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public ArrayList createTypedArrayList (Creator c)
```
Read and return a new ArrayList containing a particular object type from the parcel that was written with `https://developer.android.com/reference/android/os/Parcel#writeTypedList(java.util.List)` at the current dataPosition(). Returns null if the previously written list object was null. The list *must* have previously been written via `https://developer.android.com/reference/android/os/Parcel#writeTypedList(java.util.List)` with the same object type.
| Parameters ||
|---|---|
| `c` | `Creator`: This value cannot be `null`.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/ArrayList` | A newly created ArrayList containing objects with the same data as those that were previously written.
|
**See also:**
- `https://developer.android.com/reference/android/os/Parcel#writeTypedList(java.util.List)`
### createTypedArrayMap
Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public ArrayMap createTypedArrayMap (Creator creator)
```
Read into a new `https://developer.android.com/reference/android/util/ArrayMap` with string keys items containing a particular object type that were written with `https://developer.android.com/reference/android/os/Parcel#writeTypedArrayMap(android.util.ArrayMap,%20int)` at the current dataPosition(). The list *must* have previously been written via `https://developer.android.com/reference/android/os/Parcel#writeTypedArrayMap(android.util.ArrayMap,%20int)` with the same object type.
| Parameters ||
|---|---|
| `creator` | `Creator`: The creator to use when for instantiation. This value cannot be `null`.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/util/ArrayMap` | A newly created `https://developer.android.com/reference/android/util/ArrayMap` containing objects with the same data as those that were previously written. This value may be `null`.
|
**See also:**
- `https://developer.android.com/reference/android/os/Parcel#writeTypedArrayMap(android.util.ArrayMap,%20int)`
### createTypedSparseArray
Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public SparseArray createTypedSparseArray (Creator creator)
```
Read into a new `https://developer.android.com/reference/android/util/SparseArray` items containing a particular object type that were written with `https://developer.android.com/reference/android/os/Parcel#writeTypedSparseArray(android.util.SparseArray,%20int)` at the current dataPosition(). The list *must* have previously been written via `https://developer.android.com/reference/android/os/Parcel#writeTypedSparseArray(android.util.SparseArray,%20int)` with the same object type.
| Parameters ||
|---|---|
| `creator` | `Creator`: The creator to use when for instantiation. This value cannot be `null`.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/util/SparseArray` | A newly created `https://developer.android.com/reference/android/util/SparseArray` containing objects with the same data as those that were previously written. This value may be `null`.
|
**See also:**
- `https://developer.android.com/reference/android/os/Parcel#writeTypedSparseArray(android.util.SparseArray,%20int)`
### dataAvail
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int dataAvail ()
```
Returns the amount of data remaining to be read from the parcel. That is, `https://developer.android.com/reference/android/os/Parcel#dataSize()`-`https://developer.android.com/reference/android/os/Parcel#dataPosition()`.
| Returns ||
|---|---|
| `int` |
|
### dataCapacity
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int dataCapacity ()
```
Returns the total amount of space in the parcel. This is always \>= `https://developer.android.com/reference/android/os/Parcel#dataSize()`. The difference between it and dataSize() is the amount of room left until the parcel needs to re-allocate its data buffer.
| Returns ||
|---|---|
| `int` |
|
### dataPosition
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int dataPosition ()
```
Returns the current position in the parcel data. Never more than `https://developer.android.com/reference/android/os/Parcel#dataSize()`.
| Returns ||
|---|---|
| `int` |
|
### dataSize
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int dataSize ()
```
Returns the total amount of data contained in the parcel.
| Returns ||
|---|---|
| `int` |
|
### enforceInterface
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void enforceInterface (String interfaceName)
```
Read the header written by writeInterfaceToken and verify it matches the interface name in question. If the wrong interface type is present, `https://developer.android.com/reference/java/lang/SecurityException` is thrown. When used over binder, this exception should propagate to the caller.
| Parameters ||
|---|---|
| `interfaceName` | `String`: This value cannot be `null`.
|
### enforceNoDataAvail
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void enforceNoDataAvail ()
```
Verify there are no bytes left to be read on the Parcel.
| Throws ||
|---|---|
| `https://developer.android.com/reference/android/os/BadParcelableException` | If the current position hasn't reached the end of the Parcel. When used over binder, this exception should propagate to the caller. |
### hasFileDescriptors
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean hasFileDescriptors ()
```
Report whether the parcel contains any marshalled file descriptors. WARNING: Parcelable definitions change over time. Unless you define a Parcelable yourself OR the Parcelable explicitly guarantees that it would never include such objects, you should not expect the return value to stay the same, and your code should continue to work even if the return value changes.
| Returns ||
|---|---|
| `boolean` |
|
### hasFileDescriptors
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean hasFileDescriptors (int offset,
int length)
```
Report whether the parcel contains any marshalled file descriptors in the range defined by `offset` and `length`. WARNING: Parcelable definitions change over time. Unless you define a Parcelable yourself OR the Parcelable explicitly guarantees that it would never include such objects, you should not expect the return value to stay the same, and your code should continue to work even if the return value changes.
| Parameters ||
|---|---|
| `offset` | `int`: The offset from which the range starts. Should be between 0 and `https://developer.android.com/reference/android/os/Parcel#dataSize()`.
|
| `length` | `int`: The length of the range. Should be between 0 and `https://developer.android.com/reference/android/os/Parcel#dataSize()` - `offset`.
|
| Returns ||
|---|---|
| `boolean` | whether there are file descriptors or not.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the parameters are out of the permitted ranges. |
### marshall
Added in [version 36.1](https://developer.android.com/topic/libraries/support-library/revisions)
```
public void marshall (ByteBuffer buffer)
```
Writes the raw bytes of the parcel to a buffer.
The data you retrieve here **must not** be placed in any kind of persistent storage (on local disk, across a network, etc). For that, you should use standard serialization or another kind of general serialization mechanism. The Parcel marshalled representation is highly optimized for local IPC, and as such does not attempt to maintain compatibility with data created in different versions of the platform.
| Parameters ||
|---|---|
| `buffer` | `ByteBuffer`: The ByteBuffer to write the data to. This value cannot be `null`.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/nio/BufferOverflowException` | if the buffer is too small. |
| `https://developer.android.com/reference/java/nio/ReadOnlyBufferException` | if the buffer is read-only. |
### marshall
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public byte[] marshall ()
```
Returns the raw bytes of the parcel.
The data you retrieve here **must not** be placed in any kind of persistent storage (on local disk, across a network, etc). For that, you should use standard serialization or another kind of general serialization mechanism. The Parcel marshalled representation is highly optimized for local IPC, and as such does not attempt to maintain compatibility with data created in different versions of the platform.
| Returns ||
|---|---|
| `byte[]` |
|
### obtain
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static Parcel obtain ()
```
Retrieve a new Parcel object from the pool.
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/os/Parcel` | This value cannot be `null`.
|
### obtain
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static Parcel obtain (IBinder binder)
```
Retrieve a new Parcel object from the pool for use with a specific binder. Associate this parcel with a binder object. This marks the parcel as being prepared for a transaction on this specific binder object. Based on this, the format of the wire binder protocol may change. For future compatibility, it is recommended to use this for all Parcels.
| Parameters ||
|---|---|
| `binder` | `IBinder`: This value cannot be `null`.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/android/os/Parcel` | This value cannot be `null`.
|
### readArray
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Object[] readArray (ClassLoader loader)
```
**This method was deprecated in API level 33.**
Use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readArray(java.lang.ClassLoader,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`. Also consider changing the format to use `https://developer.android.com/reference/android/os/Parcel#createTypedArray(android.os.Parcelable.Creator)` if possible (eg. if the items' class is final) since this is also more performant. Note that changing to the latter also requires changing the writes.
Read and return a new Object array from the parcel at the current dataPosition(). Returns null if the previously written array was null. The given class loader will be used to load any enclosed Parcelables.
| Parameters ||
|---|---|
| `loader` | `ClassLoader`: This value may be `null`.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/Object` |
|
### readArray
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public T[] readArray (ClassLoader loader,
Class clazz)
```
Same as `https://developer.android.com/reference/android/os/Parcel#readArray(java.lang.ClassLoader)` but accepts `clazz` parameter as the type required for each item.
**Warning:** if the list contains items implementing the `https://developer.android.com/reference/android/os/Parcelable` interface, the class that implements `https://developer.android.com/reference/android/os/Parcelable` has to be the immediately enclosing class of the runtime type of its CREATOR field (that is, `https://developer.android.com/reference/java/lang/Class#getEnclosingClass()` has to return the parcelable implementing class), otherwise this method might throw an exception. If the Parcelable class does not enclose the CREATOR, use the deprecated `https://developer.android.com/reference/android/os/Parcel#readArray(java.lang.ClassLoader)` instead.
| Parameters ||
|---|---|
| `loader` | `ClassLoader`: This value may be `null`.
|
| `clazz` | `Class`: This value cannot be `null`.
|
| Returns ||
|---|---|
| `T[]` | This value may be `null`.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/android/os/BadParcelableException` | Throws BadParcelableException if the item to be deserialized is not an instance of that class or any of its children classes or there was an error trying to instantiate an element. |
### readArrayList
Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public ArrayList readArrayList (ClassLoader loader,
Class clazz)
```
Same as `https://developer.android.com/reference/android/os/Parcel#readArrayList(java.lang.ClassLoader)` but accepts `clazz` parameter as the type required for each item.
**Warning:** if the list contains items implementing the `https://developer.android.com/reference/android/os/Parcelable` interface, the class that implements `https://developer.android.com/reference/android/os/Parcelable` has to be the immediately enclosing class of the runtime type of its CREATOR field (that is, `https://developer.android.com/reference/java/lang/Class#getEnclosingClass()` has to return the parcelable implementing class), otherwise this method might throw an exception. If the Parcelable class does not enclose the CREATOR, use the deprecated `https://developer.android.com/reference/android/os/Parcel#readArrayList(java.lang.ClassLoader)` instead.
| Parameters ||
|---|---|
| `loader` | `ClassLoader`: This value may be `null`.
|
| `clazz` | `Class`: This value cannot be `null`.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/ArrayList` | This value may be `null`.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/android/os/BadParcelableException` | Throws BadParcelableException if the item to be deserialized is not an instance of that class or any of its children classes or there was an error trying to instantiate an element. |
### readArrayList
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Deprecated in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public ArrayList readArrayList (ClassLoader loader)
```
**This method was deprecated in API level 33.**
Use the type-safer version `https://developer.android.com/reference/android/os/Parcel#readArrayList(java.lang.ClassLoader,%20java.lang.Class)` starting from Android `https://developer.android.com/reference/android/os/Build.VERSION_CODES#TIRAMISU`. Also consider changing the format to use `https://developer.android.com/reference/android/os/Parcel#createTypedArrayList(android.os.Parcelable.Creator)` if possible (eg. if the items' class is final) since this is also more performant. Note that changing to the latter also requires changing the writes.
Read and return a new ArrayList object from the parcel at the current dataPosition(). Returns null if the previously written list object was null. The given class loader will be used to load any enclosed Parcelables.