Parcel
class Parcel
kotlin.Any | |
↳ | 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 Parcelable
interface), and references to live 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 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: writeByte
, readByte
, writeDouble
, readDouble
, writeFloat
, readFloat
, writeInt
, readInt
, writeLong
, readLong
, writeString
, 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:
-
writeBooleanArray(boolean[])
,readBooleanArray(boolean[])
,createBooleanArray()
-
writeByteArray(byte[])
,writeByteArray(byte[],int,int)
,readByteArray(byte[])
,createByteArray()
-
writeCharArray(char[])
,readCharArray(char[])
,createCharArray()
-
writeDoubleArray(double[])
,readDoubleArray(double[])
,createDoubleArray()
-
writeFloatArray(float[])
,readFloatArray(float[])
,createFloatArray()
-
writeIntArray(int[])
,readIntArray(int[])
,createIntArray()
-
writeLongArray(long[])
,readLongArray(long[])
,createLongArray()
-
writeStringArray(java.lang.String[])
,readStringArray(java.lang.String[])
,createStringArray()
. -
writeSparseBooleanArray(android.util.SparseBooleanArray)
,readSparseBooleanArray()
.
Parcelables
The 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 writeParcelable(android.os.Parcelable,int)
and readParcelable(java.lang.ClassLoader)
or writeParcelableArray
and 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: writeTypedObject
, writeTypedArray
, #writeTypedList, readTypedObject
, createTypedArray
and createTypedArrayList
. 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 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 Parcelable.writeToParcel
and Parcelable.Creator.createFromParcel
yourself.)
Bundles
A special type-safe container, called 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 writeBundle(android.os.Bundle)
, readBundle()
, and 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.
Binder
objects are a core facility of Android's general cross-process communication system. The 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 writeStrongBinder(android.os.IBinder)
, writeStrongInterface(android.os.IInterface)
, readStrongBinder()
, writeBinderArray(android.os.IBinder[])
, readBinderArray(android.os.IBinder[])
, createBinderArray()
, #writeInterfaceArray(T[]), #readInterfaceArray(T[],java.util.function.Function), createInterfaceArray(java.util.function.IntFunction,java.util.function.Function)
, writeBinderList(java.util.List)
, readBinderList(java.util.List)
, createBinderArrayList()
, writeInterfaceList(java.util.List)
, readInterfaceList(java.util.List,java.util.function.Function)
, createInterfaceArrayList(java.util.function.Function)
.
FileDescriptor objects, representing raw Linux file descriptor identifiers, can be written and 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 writeFileDescriptor(java.io.FileDescriptor)
, readFileDescriptor()
.
Parcelable Containers
A final class of methods are for writing and reading standard Java containers of arbitrary types. These all revolve around the writeValue(java.lang.Object)
and readValue(java.lang.ClassLoader)
methods which define the types of objects allowed. The container methods are writeArray(java.lang.Object[])
, readArray(java.lang.ClassLoader)
, writeList(java.util.List)
, readList(java.util.List,java.lang.ClassLoader)
, readArrayList(java.lang.ClassLoader)
, writeMap(java.util.Map)
, readMap(java.util.Map,java.lang.ClassLoader)
, writeSparseArray(android.util.SparseArray)
, 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 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 readArray(java.lang.ClassLoader,java.lang.Class)
, readList(java.util.List,java.lang.ClassLoader,java.lang.Class)
, readArrayList(java.lang.ClassLoader,java.lang.Class)
, readMap(java.util.Map,java.lang.ClassLoader,java.lang.Class,java.lang.Class)
, readSparseArray(java.lang.ClassLoader,java.lang.Class)
.
Summary
Public methods | |
---|---|
Unit |
appendFrom(parcel: Parcel!, offset: Int, length: Int) |
Array<IBinder!>? | |
ArrayList<IBinder!>? |
Read and return a new ArrayList containing IBinder objects from the parcel that was written with |
BooleanArray? | |
ByteArray? |
Read and return a byte[] object from the parcel. |
CharArray? | |
DoubleArray? | |
T? |
createFixedArray(cls: Class<T>, vararg dimensions: Int) Read and return a new multi-dimensional array from a parcel. |
T? |
createFixedArray(cls: Class<T>, asInterface: Function<IBinder!, S>, vararg dimensions: Int) Read and return a new multi-dimensional array of typed interfaces from a parcel. |
T? |
createFixedArray(cls: Class<T>, c: Parcelable.Creator<S>, vararg dimensions: Int) Read and return a new multi-dimensional array of typed parcelables from a parcel. |
FloatArray? | |
IntArray? | |
Array<T>? |
createInterfaceArray(newArray: IntFunction<Array<T>!>, asInterface: Function<IBinder!, T>) Read and return a new array of T (IInterface) from the parcel. |
ArrayList<T>? |
createInterfaceArrayList(asInterface: Function<IBinder!, T>) Read and return a new ArrayList containing T (IInterface) objects from the parcel that was written with |
LongArray? | |
Array<String!>? | |
ArrayList<String!>? |
Read and return a new ArrayList containing String objects from the parcel that was written with |
Array<T>? |
Read and return a new array containing a particular object type from the parcel at the current dataPosition(). |
ArrayList<T>? |
Read and return a new ArrayList containing a particular object type from the parcel that was written with #writeTypedList at the current dataPosition(). |
ArrayMap<String!, T>? |
createTypedArrayMap(creator: Parcelable.Creator<T>) Read into a new |
SparseArray<T>? |
createTypedSparseArray(creator: Parcelable.Creator<T>) Read into a new |
Int |
Returns the amount of data remaining to be read from the parcel. |
Int |
Returns the total amount of space in the parcel. |
Int |
Returns the current position in the parcel data. |
Int |
dataSize() Returns the total amount of data contained in the parcel. |
Unit |
enforceInterface(interfaceName: String) Read the header written by writeInterfaceToken and verify it matches the interface name in question. |
Unit |
Verify there are no bytes left to be read on the Parcel. |
Boolean |
Report whether the parcel contains any marshalled file descriptors. |
Boolean |
hasFileDescriptors(offset: Int, length: Int) Report whether the parcel contains any marshalled file descriptors in the range defined by |
ByteArray! |
marshall() Returns the raw bytes of the parcel. |
static Parcel |
obtain() Retrieve a new Parcel object from the pool. |
static Parcel |
Retrieve a new Parcel object from the pool for use with a specific binder. |
Array<Any!>? |
readArray(loader: ClassLoader?) Read and return a new Object array from the parcel at the current dataPosition(). |
Array<T>? |
readArray(loader: ClassLoader?, clazz: Class<T>) Same as |
ArrayList<Any!>? |
readArrayList(loader: ClassLoader?) Read and return a new ArrayList object from the parcel at the current dataPosition(). |
ArrayList<T>? |
readArrayList(loader: ClassLoader?, clazz: Class<out T>) Same as |
Unit |
readBinderArray(val: Array<IBinder!>) |
Unit |
readBinderList(list: MutableList<IBinder!>) Read into the given List items IBinder objects that were written with |
ByteArray? |
readBlob() Read a blob of data from the parcel and return it as a byte array. |
Boolean |
Read a boolean value from the parcel at the current dataPosition(). |
Unit |
readBooleanArray(val: BooleanArray) |
Bundle? |
Read and return a new Bundle object from the parcel at the current dataPosition(). |
Bundle? |
readBundle(loader: ClassLoader?) 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 |
readByte() Read a byte value from the parcel at the current dataPosition(). |
Unit |
readByteArray(val: ByteArray) Read a byte[] object from the parcel and copy it into the given byte array. |
Unit |
readCharArray(val: CharArray) |
Double |
Read a double precision floating point value from the parcel at the current dataPosition(). |
Unit |
readDoubleArray(val: DoubleArray) |
Unit |
Special function for reading an exception result from the header of a parcel, to be used after receiving the result of a transaction. |
Unit |
readException(code: Int, msg: String!) Throw an exception with the given message. |
ParcelFileDescriptor! |
Read a FileDescriptor from the parcel at the current dataPosition(). |
Unit |
readFixedArray(val: T) Read a new multi-dimensional array from a parcel. |
Unit |
readFixedArray(val: T, asInterface: Function<IBinder!, S>) Read a new multi-dimensional array of typed interfaces from a parcel. |
Unit |
readFixedArray(val: T, c: Parcelable.Creator<S>) Read a new multi-dimensional array of typed parcelables from a parcel. |
Float |
Read a floating point value from the parcel at the current dataPosition(). |
Unit |
readFloatArray(val: FloatArray) |
HashMap<Any!, Any!>? |
readHashMap(loader: ClassLoader?) Please use |
HashMap<K, V>? |
readHashMap(loader: ClassLoader?, clazzKey: Class<out K>, clazzValue: Class<out V>) Same as |
Int |
readInt() Read an integer value from the parcel at the current dataPosition(). |
Unit |
readIntArray(val: IntArray) |
Unit |
readInterfaceArray(val: Array<T>, asInterface: Function<IBinder!, T>) Read an array of T (IInterface) from a parcel. |
Unit |
readInterfaceList(list: MutableList<T>, asInterface: Function<IBinder!, T>) Read into the given List items IInterface objects that were written with |
Unit |
readList(outVal: MutableList<Any?>, loader: ClassLoader?) Read into an existing List object from the parcel at the current dataPosition(), using the given class loader to load any enclosed Parcelables. |
Unit |
readList(outVal: MutableList<in T>, loader: ClassLoader?, clazz: Class<T>) Same as |
Long |
readLong() Read a long integer value from the parcel at the current dataPosition(). |
Unit |
readLongArray(val: LongArray) |
Unit |
readMap(outVal: MutableMap<Any?, Any?>, loader: ClassLoader?) Please use |
Unit |
readMap(outVal: MutableMap<in K, in V>, loader: ClassLoader?, clazzKey: Class<K>, clazzValue: Class<V>) Same as |
T? |
readParcelable(loader: ClassLoader?) Read and return a new Parcelable from the parcel. |
T? |
readParcelable(loader: ClassLoader?, clazz: Class<T>) Same as |
Array<Parcelable!>? |
readParcelableArray(loader: ClassLoader?) Read and return a new Parcelable array from the parcel. |
Array<T>? |
readParcelableArray(loader: ClassLoader?, clazz: Class<T>) Same as |
Parcelable.Creator<*>? |
readParcelableCreator(loader: ClassLoader?) Read and return a Parcelable. |
Parcelable.Creator<T>? |
readParcelableCreator(loader: ClassLoader?, clazz: Class<T>) Same as |
MutableList<T> |
readParcelableList(list: MutableList<T>, cl: ClassLoader?) Read the list of |
MutableList<T> |
readParcelableList(list: MutableList<T>, cl: ClassLoader?, clazz: Class<out T>) Same as |
PersistableBundle? |
Read and return a new Bundle object from the parcel at the current dataPosition(). |
PersistableBundle? |
readPersistableBundle(loader: ClassLoader?) 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. |
Serializable? |
Read and return a new Serializable object from the parcel. |
T? |
readSerializable(loader: ClassLoader?, clazz: Class<T>) Same as |
Size |
readSize() Read a Size from the parcel at the current dataPosition(). |
SizeF |
Read a SizeF from the parcel at the current dataPosition(). |
SparseArray<T>? |
readSparseArray(loader: ClassLoader?) Read and return a new SparseArray object from the parcel at the current dataPosition(). |
SparseArray<T>? |
readSparseArray(loader: ClassLoader?, clazz: Class<out T>) Same as |
SparseBooleanArray? |
Read and return a new SparseBooleanArray object from the parcel at the current dataPosition(). |
String? |
Read a string value from the parcel at the current dataPosition(). |
Unit |
readStringArray(val: Array<String!>) |
Unit |
readStringList(list: MutableList<String!>) Read into the given List items String objects that were written with |
IBinder! |
Read an object from the parcel at the current dataPosition(). |
Unit |
readTypedArray(val: Array<T>, c: Parcelable.Creator<T>) |
Unit |
readTypedList(list: MutableList<T>, c: Parcelable.Creator<T>) Read into the given List items containing a particular object type that were written with #writeTypedList at the current dataPosition(). |
T? |
Read and return a typed Parcelable object from a parcel. |
Any? |
readValue(loader: ClassLoader?) Read a typed object from a parcel. |
Unit |
recycle() Put a Parcel object back into the pool. |
Unit |
setDataCapacity(size: Int) Change the capacity (current available space) of the parcel. |
Unit |
setDataPosition(pos: Int) Move the current read/write position in the parcel. |
Unit |
setDataSize(size: Int) Change the amount of data in the parcel. |
Unit |
This method is used by the AIDL compiler for system components. |
Unit |
unmarshall(data: ByteArray, offset: Int, length: Int) Fills the raw bytes of this Parcel with the supplied data. |
Unit |
writeArray(val: Array<Any!>?) Flatten an Object array into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeBinderArray(val: Array<IBinder!>?) |
Unit |
writeBinderList(val: MutableList<IBinder!>?) Flatten a List containing IBinder objects into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
Unit |
Write a blob of data into the parcel at the current |
Unit |
Write a blob of data into the parcel at the current |
Unit |
writeBoolean(val: Boolean) Write a boolean value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeBooleanArray(val: BooleanArray?) |
Unit |
writeBundle(val: Bundle?) Flatten a Bundle into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
Write a byte value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeByteArray(b: ByteArray?) Write a byte array into the parcel at the current |
Unit |
writeByteArray(b: ByteArray?, offset: Int, len: Int) Write a byte array into the parcel at the current |
Unit |
writeCharArray(val: CharArray?) |
Unit |
writeDouble(val: Double) Write a double precision floating point value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeDoubleArray(val: DoubleArray?) |
Unit |
Special function for writing an exception result at the header of a parcel, to be used when returning an exception from a transaction. |
Unit |
Write a FileDescriptor into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeFixedArray(val: T?, parcelableFlags: Int, vararg dimensions: Int) Flatten a homogeneous multi-dimensional array with fixed-size. |
Unit |
writeFloat(val: Float) Write a floating point value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeFloatArray(val: FloatArray?) |
Unit |
Write an integer value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeIntArray(val: IntArray?) |
Unit |
writeInterfaceArray(val: Array<T>?) Flatten a homogeneous array containing an IInterface type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
Unit |
writeInterfaceList(val: MutableList<T>?) Flatten a |
Unit |
writeInterfaceToken(interfaceName: String) Store or read an IBinder interface token in the parcel at the current |
Unit |
writeList(val: MutableList<Any?>?) Flatten a List into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
Write a long integer value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeLongArray(val: LongArray?) |
Unit |
writeMap(val: MutableMap<Any?, Any?>?) Please use |
Unit |
Special function for writing information at the front of the Parcel indicating that no exception occurred. |
Unit |
writeParcelable(p: Parcelable?, parcelableFlags: Int) Flatten the name of the class of the Parcelable and its contents into the parcel. |
Unit |
writeParcelableArray(value: Array<T>?, parcelableFlags: Int) Write a heterogeneous array of Parcelable objects into the Parcel. |
Unit |
Flatten the name of the class of the Parcelable into this Parcel. |
Unit |
writeParcelableList(val: MutableList<T>?, flags: Int) Flatten a |
Unit |
Flatten a PersistableBundle into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
Write a generic serializable object in to a Parcel. |
Unit |
Flatten a Size into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeSizeF(val: SizeF) Flatten a SizeF into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeSparseArray(val: SparseArray<T>?) Flatten a generic SparseArray into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit | |
Unit |
writeString(val: String?) Write a string value into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeStringArray(val: Array<String!>?) |
Unit |
writeStringList(val: MutableList<String!>?) Flatten a List containing String objects into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
Unit |
writeStrongBinder(val: IBinder!) Write an object into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeStrongInterface(val: IInterface!) Write an object into the parcel at the current dataPosition(), growing dataCapacity() if needed. |
Unit |
writeTypedArray(val: Array<T>?, parcelableFlags: Int) Flatten a homogeneous array containing a particular object type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
Unit |
writeTypedArrayMap(val: ArrayMap<String!, T>?, parcelableFlags: Int) Flatten an |
Unit |
writeTypedList(val: MutableList<T>?) Flatten a List containing a particular object type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
Unit |
writeTypedList(val: MutableList<T>?, parcelableFlags: Int) Flatten a List containing a particular object type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. |
Unit |
writeTypedObject(val: T?, parcelableFlags: Int) Flatten the Parcelable object into the parcel. |
Unit |
writeTypedSparseArray(val: SparseArray<T>?, parcelableFlags: Int) Flatten a |
Unit |
writeValue(v: Any?) Flatten a generic object in to a parcel. |
Protected methods | |
---|---|
Unit |
finalize() |
Properties | |
---|---|
static Parcelable.Creator<String!>! |
Public methods
createBinderArray
fun createBinderArray(): Array<IBinder!>?
Return | |
---|---|
Array<IBinder!>? |
This value may be null . |
createBinderArrayList
fun createBinderArrayList(): ArrayList<IBinder!>?
Read and return a new ArrayList containing IBinder objects from the parcel that was written with writeBinderList
at the current dataPosition(). Returns null if the previously written list object was null.
Return | |
---|---|
ArrayList<IBinder!>? |
A newly created ArrayList containing strings with the same data as those that were previously written. |
See Also
createBooleanArray
fun createBooleanArray(): BooleanArray?
Return | |
---|---|
BooleanArray? |
This value may be null . |
createByteArray
fun createByteArray(): ByteArray?
Read and return a byte[] object from the parcel.
Return | |
---|---|
ByteArray? |
This value may be null . |
createCharArray
fun createCharArray(): CharArray?
Return | |
---|---|
CharArray? |
This value may be null . |
createDoubleArray
fun createDoubleArray(): DoubleArray?
Return | |
---|---|
DoubleArray? |
This value may be null . |
createFixedArray
fun <T : Any!> createFixedArray(
cls: Class<T>,
vararg dimensions: Int
): T?
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 createFixedArray(java.lang.Class,android.os.Parcelable.Creator,int[])
or createFixedArray(java.lang.Class,java.util.function.Function,int[])
.
Parameters | |
---|---|
cls |
Class<T>: 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 . |
createFixedArray
fun <T : Any!, S : IInterface!> createFixedArray(
cls: Class<T>,
asInterface: Function<IBinder!, S>,
vararg dimensions: Int
): T?
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 createFixedArray(java.lang.Class,android.os.Parcelable.Creator,int[])
. For values of other types use createFixedArray(java.lang.Class,int[])
.
Parameters | |
---|---|
cls |
Class<T>: the Class object for the target array type. (e.g. IFoo[][].class) This value cannot be null . |
dimensions |
Int: an array of int representing length of each dimension. This value cannot be null . |
asInterface |
Function<IBinder!, S>: This value cannot be null . |
createFixedArray
fun <T : Any!, S : Parcelable!> createFixedArray(
cls: Class<T>,
c: Parcelable.Creator<S>,
vararg dimensions: Int
): T?
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 createFixedArray(java.lang.Class,java.util.function.Function,int[])
. For values of other types use createFixedArray(java.lang.Class,int[])
.
Parameters | |
---|---|
cls |
Class<T>: the Class object for the target array type. (e.g. Foo[][].class) This value cannot be null . |
dimensions |
Int: an array of int representing length of each dimension. This value cannot be null . |
c |
Parcelable.Creator<S>: This value cannot be null . |
createFloatArray
fun createFloatArray(): FloatArray?
Return | |
---|---|
FloatArray? |
This value may be null . |
createIntArray
fun createIntArray(): IntArray?
Return | |
---|---|
IntArray? |
This value may be null . |
createInterfaceArray
fun <T : IInterface!> createInterfaceArray(
newArray: IntFunction<Array<T>!>,
asInterface: Function<IBinder!, T>
): Array<T>?
Read and return a new array of T (IInterface) from the parcel.
Parameters | |
---|---|
newArray |
IntFunction<Array<T>!>: a function to create an array of T with a given length This value cannot be null . |
asInterface |
Function<IBinder!, T>: a function to convert IBinder object into T (IInterface) This value cannot be null . |
Return | |
---|---|
Array<T>? |
the IInterface array of type T This value may be null . |
createInterfaceArrayList
fun <T : IInterface!> createInterfaceArrayList(asInterface: Function<IBinder!, T>): ArrayList<T>?
Read and return a new ArrayList containing T (IInterface) objects from the parcel that was written with writeInterfaceList
at the current dataPosition(). Returns null if the previously written list object was null.
Parameters | |
---|---|
asInterface |
Function<IBinder!, T>: This value cannot be null . |
Return | |
---|---|
ArrayList<T>? |
A newly created ArrayList containing T (IInterface) |
See Also
createLongArray
fun createLongArray(): LongArray?
Return | |
---|---|
LongArray? |
This value may be null . |
createStringArray
fun createStringArray(): Array<String!>?
Return | |
---|---|
Array<String!>? |
This value may be null . |
createStringArrayList
fun createStringArrayList(): ArrayList<String!>?
Read and return a new ArrayList containing String objects from the parcel that was written with writeStringList
at the current dataPosition(). Returns null if the previously written list object was null.
Return | |
---|---|
ArrayList<String!>? |
A newly created ArrayList containing strings with the same data as those that were previously written. |
See Also
createTypedArray
fun <T : Any!> createTypedArray(c: Parcelable.Creator<T>): Array<T>?
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 writeTypedArray
with the same object type.
Parameters | |
---|---|
c |
Parcelable.Creator<T>: This value cannot be null . |
Return | |
---|---|
Array<T>? |
A newly created array containing objects with the same data as those that were previously written. |
See Also
createTypedArrayList
fun <T : Any!> createTypedArrayList(c: Parcelable.Creator<T>): ArrayList<T>?
Read and return a new ArrayList containing a particular object type from the parcel that was written with #writeTypedList at the current dataPosition(). Returns null if the previously written list object was null. The list must have previously been written via #writeTypedList with the same object type.
Parameters | |
---|---|
c |
Parcelable.Creator<T>: This value cannot be null . |
Return | |
---|---|
ArrayList<T>? |
A newly created ArrayList containing objects with the same data as those that were previously written. |
See Also
createTypedArrayMap
fun <T : Parcelable!> createTypedArrayMap(creator: Parcelable.Creator<T>): ArrayMap<String!, T>?
Read into a new ArrayMap
with string keys items containing a particular object type that were written with writeTypedArrayMap(android.util.ArrayMap,int)
at the current dataPosition(). The list must have previously been written via writeTypedArrayMap(android.util.ArrayMap,int)
with the same object type.
Parameters | |
---|---|
creator |
Parcelable.Creator<T>: The creator to use when for instantiation. This value cannot be null . |
Return | |
---|---|
ArrayMap<String!, T>? |
A newly created ArrayMap containing objects with the same data as those that were previously written. This value may be null . |
See Also
createTypedSparseArray
fun <T : Parcelable!> createTypedSparseArray(creator: Parcelable.Creator<T>): SparseArray<T>?
Read into a new SparseArray
items containing a particular object type that were written with writeTypedSparseArray(android.util.SparseArray,int)
at the current dataPosition(). The list must have previously been written via writeTypedSparseArray(android.util.SparseArray,int)
with the same object type.
Parameters | |
---|---|
creator |
Parcelable.Creator<T>: The creator to use when for instantiation. This value cannot be null . |
Return | |
---|---|
SparseArray<T>? |
A newly created SparseArray containing objects with the same data as those that were previously written. This value may be null . |
dataAvail
fun dataAvail(): Int
Returns the amount of data remaining to be read from the parcel. That is, dataSize
-dataPosition
.
dataCapacity
fun dataCapacity(): Int
Returns the total amount of space in the parcel. This is always >= dataSize
. The difference between it and dataSize() is the amount of room left until the parcel needs to re-allocate its data buffer.
dataPosition
fun dataPosition(): Int
Returns the current position in the parcel data. Never more than dataSize
.
dataSize
fun dataSize(): Int
Returns the total amount of data contained in the parcel.
enforceInterface
fun enforceInterface(interfaceName: String): Unit
Read the header written by writeInterfaceToken and verify it matches the interface name in question. If the wrong interface type is present, SecurityException
is thrown. When used over binder, this exception should propagate to the caller.
Parameters | |
---|---|
interfaceName |
String: This value cannot be null . |
enforceNoDataAvail
fun enforceNoDataAvail(): Unit
Verify there are no bytes left to be read on the Parcel.
Exceptions | |
---|---|
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
fun hasFileDescriptors(): Boolean
Report whether the parcel contains any marshalled file descriptors.
hasFileDescriptors
fun hasFileDescriptors(
offset: Int,
length: Int
): Boolean
Report whether the parcel contains any marshalled file descriptors in the range defined by offset
and length
.
Parameters | |
---|---|
offset |
Int: The offset from which the range starts. Should be between 0 and dataSize() . |
length |
Int: The length of the range. Should be between 0 and dataSize() - offset . |
Return | |
---|---|
Boolean |
whether there are file descriptors or not. |
Exceptions | |
---|---|
java.lang.IllegalArgumentException |
if the parameters are out of the permitted ranges. |
marshall
fun marshall(): ByteArray!
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.
obtain
static fun obtain(): Parcel
Retrieve a new Parcel object from the pool.
Return | |
---|---|
Parcel |
This value cannot be null . |
obtain
static fun obtain(binder: IBinder): Parcel
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 . |
Return | |
---|---|
Parcel |
This value cannot be null . |
readArray
funreadArray(loader: ClassLoader?): Array<Any!>?
Deprecated: Use the type-safer version readArray(java.lang.ClassLoader,java.lang.Class)
starting from Android Build.VERSION_CODES#TIRAMISU
. Also consider changing the format to use 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 . |
readArray
fun <T : Any!> readArray(
loader: ClassLoader?,
clazz: Class<T>
): Array<T>?
Same as readArray(java.lang.ClassLoader)
but accepts clazz
parameter as the type required for each item.
Warning: if the list contains items implementing the Parcelable
interface, the class that implements Parcelable
has to be the immediately enclosing class of the runtime type of its CREATOR field (that is, 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 readArray(java.lang.ClassLoader)
instead.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
clazz |
Class<T>: This value cannot be null . |
Return | |
---|---|
Array<T>? |
This value may be null . |
Exceptions | |
---|---|
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
funreadArrayList(loader: ClassLoader?): ArrayList<Any!>?
Deprecated: Use the type-safer version readArrayList(java.lang.ClassLoader,java.lang.Class)
starting from Android Build.VERSION_CODES#TIRAMISU
. Also consider changing the format to use 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.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
readArrayList
fun <T : Any!> readArrayList(
loader: ClassLoader?,
clazz: Class<out T>
): ArrayList<T>?
Same as readArrayList(java.lang.ClassLoader)
but accepts clazz
parameter as the type required for each item.
Warning: if the list contains items implementing the Parcelable
interface, the class that implements Parcelable
has to be the immediately enclosing class of the runtime type of its CREATOR field (that is, 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 readArrayList(java.lang.ClassLoader)
instead.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
clazz |
Class<out T>: This value cannot be null . |
Return | |
---|---|
ArrayList<T>? |
This value may be null . |
Exceptions | |
---|---|
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. |
readBinderArray
fun readBinderArray(val: Array<IBinder!>): Unit
Parameters | |
---|---|
val |
Array<IBinder!>: This value cannot be null . |
readBinderList
fun readBinderList(list: MutableList<IBinder!>): Unit
Read into the given List items IBinder objects that were written with writeBinderList
at the current dataPosition().
Parameters | |
---|---|
list |
MutableList<IBinder!>: This value cannot be null . |
See Also
readBlob
fun readBlob(): ByteArray?
Read a blob of data from the parcel and return it as a byte array.
Return | |
---|---|
ByteArray? |
This value may be null . |
See Also
readBoolean
fun readBoolean(): Boolean
Read a boolean value from the parcel at the current dataPosition().
readBooleanArray
fun readBooleanArray(val: BooleanArray): Unit
Parameters | |
---|---|
val |
BooleanArray: This value cannot be null . |
readBundle
fun readBundle(): Bundle?
Read and return a new Bundle object from the parcel at the current dataPosition(). Returns null if the previously written Bundle object was null.
readBundle
fun readBundle(loader: ClassLoader?): Bundle?
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. Returns null if the previously written Bundle object was null.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
readByte
fun readByte(): Byte
Read a byte value from the parcel at the current dataPosition().
readByteArray
fun readByteArray(val: ByteArray): Unit
Read a byte[] object from the parcel and copy it into the given byte array.
Parameters | |
---|---|
val |
ByteArray: This value cannot be null . |
readCharArray
fun readCharArray(val: CharArray): Unit
Parameters | |
---|---|
val |
CharArray: This value cannot be null . |
readDouble
fun readDouble(): Double
Read a double precision floating point value from the parcel at the current dataPosition().
readDoubleArray
fun readDoubleArray(val: DoubleArray): Unit
Parameters | |
---|---|
val |
DoubleArray: This value cannot be null . |
readException
fun readException(): Unit
Special function for reading an exception result from the header of a parcel, to be used after receiving the result of a transaction. This will throw the exception for you if it had been written to the Parcel, otherwise return and let you read the normal result data from the Parcel.
See Also
readException
fun readException(
code: Int,
msg: String!
): Unit
Throw an exception with the given message. Not intended for use outside the Parcel class.
Parameters | |
---|---|
code |
Int: Used to determine which exception class to throw. |
msg |
String!: The exception message. |
readFileDescriptor
fun readFileDescriptor(): ParcelFileDescriptor!
Read a FileDescriptor from the parcel at the current dataPosition().
readFixedArray
fun <T : Any!> readFixedArray(val: T): Unit
Read a new multi-dimensional array from a parcel. If you want to read Parcelable or IInterface values, use readFixedArray(java.lang.Object,android.os.Parcelable.Creator)
or readFixedArray(java.lang.Object,java.util.function.Function)
.
Parameters | |
---|---|
val |
T: the destination array to hold the read values. This value cannot be null . |
readFixedArray
fun <T : Any!, S : IInterface!> readFixedArray(
val: T,
asInterface: Function<IBinder!, S>
): Unit
Read a new multi-dimensional array of typed interfaces from a parcel. If you want to read Parcelable values, use readFixedArray(java.lang.Object,android.os.Parcelable.Creator)
. For values of other types, use readFixedArray(java.lang.Object)
.
Parameters | |
---|---|
val |
T: the destination array to hold the read values. This value cannot be null . |
asInterface |
Function<IBinder!, S>: This value cannot be null . |
readFixedArray
fun <T : Any!, S : Parcelable!> readFixedArray(
val: T,
c: Parcelable.Creator<S>
): Unit
Read a new multi-dimensional array of typed parcelables from a parcel. If you want to read IInterface values, use readFixedArray(java.lang.Object,java.util.function.Function)
. For values of other types, use readFixedArray(java.lang.Object)
.
Parameters | |
---|---|
val |
T: the destination array to hold the read values. This value cannot be null . |
c |
Parcelable.Creator<S>: This value cannot be null . |
readFloat
fun readFloat(): Float
Read a floating point value from the parcel at the current dataPosition().
readFloatArray
fun readFloatArray(val: FloatArray): Unit
Parameters | |
---|---|
val |
FloatArray: This value cannot be null . |
readHashMap
funreadHashMap(loader: ClassLoader?): HashMap<Any!, Any!>?
Deprecated: Consider using readBundle(java.lang.ClassLoader)
as stated above, in case this method is still preferred use the type-safer version readHashMap(java.lang.ClassLoader,java.lang.Class,java.lang.Class)
starting from Android Build.VERSION_CODES#TIRAMISU
.
Please use readBundle(java.lang.ClassLoader)
instead (whose data must have been written with writeBundle
. Read and return a new HashMap object from the parcel at the current dataPosition(), using the given class loader to load any enclosed Parcelables. Returns null if the previously written map object was null.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
readHashMap
fun <K : Any!, V : Any!> readHashMap(
loader: ClassLoader?,
clazzKey: Class<out K>,
clazzValue: Class<out V>
): HashMap<K, V>?
Same as readHashMap(java.lang.ClassLoader)
but accepts clazzKey
and clazzValue
parameter as the types required for each key and value pair.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
clazzKey |
Class<out K>: This value cannot be null . |
clazzValue |
Class<out V>: This value cannot be null . |
Return | |
---|---|
HashMap<K, V>? |
This value may be null . |
Exceptions | |
---|---|
android.os.BadParcelableException |
if the item to be deserialized is not an instance of that class or any of its children class |
readInt
fun readInt(): Int
Read an integer value from the parcel at the current dataPosition().
readIntArray
fun readIntArray(val: IntArray): Unit
Parameters | |
---|---|
val |
IntArray: This value cannot be null . |
readInterfaceArray
fun <T : IInterface!> readInterfaceArray(
val: Array<T>,
asInterface: Function<IBinder!, T>
): Unit
Read an array of T (IInterface) from a parcel.
Parameters | |
---|---|
asInterface |
Function<IBinder!, T>: a function to convert IBinder object into T (IInterface) This value cannot be null . |
val |
Array<T>: This value cannot be null . |
Exceptions | |
---|---|
android.os.BadParcelableException |
Throws BadParcelableException if the length of `val` mismatches the number of items in the parcel. |
readInterfaceList
fun <T : IInterface!> readInterfaceList(
list: MutableList<T>,
asInterface: Function<IBinder!, T>
): Unit
Read into the given List items IInterface objects that were written with writeInterfaceList
at the current dataPosition().
Parameters | |
---|---|
list |
MutableList<T>: This value cannot be null . |
asInterface |
Function<IBinder!, T>: This value cannot be null . |
See Also
readList
funreadList(
outVal: MutableList<Any?>,
loader: ClassLoader?
): Unit
Deprecated: Use the type-safer version readList(java.util.List,java.lang.ClassLoader,java.lang.Class)
starting from Android Build.VERSION_CODES#TIRAMISU
. Also consider changing the format to use readTypedList(java.util.List,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 into an existing List object from the parcel at the current dataPosition(), using the given class loader to load any enclosed Parcelables. If it is null, the default class loader is used.
Parameters | |
---|---|
outVal |
MutableList<Any?>: This value cannot be null . |
loader |
ClassLoader?: This value may be null . |
readList
fun <T : Any!> readList(
outVal: MutableList<in T>,
loader: ClassLoader?,
clazz: Class<T>
): Unit
Same as readList(java.util.List,java.lang.ClassLoader)
but accepts clazz
parameter as the type required for each item.
Warning: if the list contains items implementing the Parcelable
interface, the class that implements Parcelable
has to be the immediately enclosing class of the runtime type of its CREATOR field (that is, 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 readList(java.util.List,java.lang.ClassLoader)
instead.
Parameters | |
---|---|
outVal |
MutableList<in T>: This value cannot be null . |
loader |
ClassLoader?: This value may be null . |
clazz |
Class<T>: This value cannot be null . |
Exceptions | |
---|---|
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. |
readLong
fun readLong(): Long
Read a long integer value from the parcel at the current dataPosition().
readLongArray
fun readLongArray(val: LongArray): Unit
Parameters | |
---|---|
val |
LongArray: This value cannot be null . |
readMap
funreadMap(
outVal: MutableMap<Any?, Any?>,
loader: ClassLoader?
): Unit
Deprecated: Consider using readBundle(java.lang.ClassLoader)
as stated above, in case this method is still preferred use the type-safer version readMap(java.util.Map,java.lang.ClassLoader,java.lang.Class,java.lang.Class)
starting from Android Build.VERSION_CODES#TIRAMISU
.
Please use readBundle(java.lang.ClassLoader)
instead (whose data must have been written with writeBundle
. Read into an existing Map object from the parcel at the current dataPosition().
Parameters | |
---|---|
outVal |
MutableMap<Any?, Any?>: This value cannot be null . |
loader |
ClassLoader?: This value may be null . |
readMap
fun <K : Any!, V : Any!> readMap(
outVal: MutableMap<in K, in V>,
loader: ClassLoader?,
clazzKey: Class<K>,
clazzValue: Class<V>
): Unit
Same as readMap(java.util.Map,java.lang.ClassLoader)
but accepts clazzKey
and clazzValue
parameter as the types required for each key and value pair.
Parameters | |
---|---|
outVal |
MutableMap<in K, in V>: This value cannot be null . |
loader |
ClassLoader?: This value may be null . |
clazzKey |
Class<K>: This value cannot be null . |
clazzValue |
Class<V>: This value cannot be null . |
Exceptions | |
---|---|
android.os.BadParcelableException |
If the item to be deserialized is not an instance of that class or any of its children class |
readParcelable
fun <T : Parcelable!>readParcelable(loader: ClassLoader?): T?
Deprecated: Use the type-safer version readParcelable(java.lang.ClassLoader,java.lang.Class)
starting from Android Build.VERSION_CODES#TIRAMISU
. Also consider changing the format to use Parcelable.Creator#createFromParcel(Parcel)
if possible since this is also more performant. Note that changing to the latter also requires changing the writes.
Read and return a new Parcelable from the parcel. The given class loader will be used to load any enclosed Parcelables. If it is null, the default class loader will be used.
Parameters | |
---|---|
loader |
ClassLoader?: A ClassLoader from which to instantiate the Parcelable object, or null for the default class loader. |
Return | |
---|---|
T? |
Returns the newly created Parcelable, or null if a null object has been written. |
Exceptions | |
---|---|
android.os.BadParcelableException |
Throws BadParcelableException if there was an error trying to instantiate the Parcelable. |
readParcelable
fun <T : Any!> readParcelable(
loader: ClassLoader?,
clazz: Class<T>
): T?
Same as readParcelable(java.lang.ClassLoader)
but accepts clazz
parameter as the type required for each item.
Warning: the class that implements Parcelable
has to be the immediately enclosing class of the runtime type of its CREATOR field (that is, 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 readParcelable(java.lang.ClassLoader)
instead.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
clazz |
Class<T>: This value cannot be null . |
Return | |
---|---|
T? |
This value may be null . |
Exceptions | |
---|---|
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. |
readParcelableArray
funreadParcelableArray(loader: ClassLoader?): Array<Parcelable!>?
Deprecated: Use the type-safer version readParcelableArray(java.lang.ClassLoader,java.lang.Class)
starting from Android Build.VERSION_CODES#TIRAMISU
. Also consider changing the format to use 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 Parcelable array from the parcel. The given class loader will be used to load any enclosed Parcelables.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
Return | |
---|---|
Array<Parcelable!>? |
the Parcelable array, or null if the array is null |
readParcelableArray
fun <T : Any!> readParcelableArray(
loader: ClassLoader?,
clazz: Class<T>
): Array<T>?
Same as readParcelableArray(java.lang.ClassLoader)
but accepts clazz
parameter as the type required for each item.
Warning: the class that implements Parcelable
has to be the immediately enclosing class of the runtime type of its CREATOR field (that is, 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 readParcelableArray(java.lang.ClassLoader)
instead.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
clazz |
Class<T>: This value cannot be null . |
Return | |
---|---|
Array<T>? |
This value may be null . |
Exceptions | |
---|---|
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. |
readParcelableCreator
funreadParcelableCreator(loader: ClassLoader?): Parcelable.Creator<*>?
Deprecated: Use the type-safer version readParcelableCreator(java.lang.ClassLoader,java.lang.Class)
starting from Android Build.VERSION_CODES#TIRAMISU
.
Read and return a Parcelable.Creator from the parcel. The given class loader will be used to load the Parcelable.Creator
. If it is null, the default class loader will be used.
Parameters | |
---|---|
loader |
ClassLoader?: A ClassLoader from which to instantiate the Parcelable.Creator object, or null for the default class loader. |
Return | |
---|---|
Parcelable.Creator<*>? |
the previously written Parcelable.Creator , or null if a null Creator was written. |
Exceptions | |
---|---|
android.os.BadParcelableException |
Throws BadParcelableException if there was an error trying to read the Parcelable.Creator . |
See Also
readParcelableCreator
fun <T : Any!> readParcelableCreator(
loader: ClassLoader?,
clazz: Class<T>
): Parcelable.Creator<T>?
Same as readParcelableCreator(java.lang.ClassLoader)
but accepts clazz
parameter as the required type.
Warning: the class that implements Parcelable
has to be the immediately enclosing class of the runtime type of its CREATOR field (that is, 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 instead.
readParcelableList
fun <T : Parcelable!>readParcelableList(
list: MutableList<T>,
cl: ClassLoader?
): MutableList<T>
Deprecated: Use the type-safer version readParcelableList(java.util.List,java.lang.ClassLoader,java.lang.Class)
starting from Android Build.VERSION_CODES#TIRAMISU
. Also consider changing the format to use readTypedList(java.util.List,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 the list of Parcelable
objects at the current data position into the given list
. The contents of the list
are replaced. If the serialized list was null
, list
is cleared.
Parameters | |
---|---|
list |
MutableList<T>: This value cannot be null . |
cl |
ClassLoader?: This value may be null . |
See Also
readParcelableList
fun <T : Any!> readParcelableList(
list: MutableList<T>,
cl: ClassLoader?,
clazz: Class<out T>
): MutableList<T>
Same as readParcelableList(java.util.List,java.lang.ClassLoader)
but accepts clazz
parameter as the type required for each item.
Warning: if the list contains items implementing the Parcelable
interface, the class that implements Parcelable
has to be the immediately enclosing class of the runtime type of its CREATOR field (that is, 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 readParcelableList(java.util.List,java.lang.ClassLoader)
instead.
Parameters | |
---|---|
list |
MutableList<T>: This value cannot be null . |
cl |
ClassLoader?: This value may be null . |
clazz |
Class<out T>: This value cannot be null . |
Return | |
---|---|
MutableList<T> |
This value cannot be null . |
Exceptions | |
---|---|
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. |
readPersistableBundle
fun readPersistableBundle(): PersistableBundle?
Read and return a new Bundle object from the parcel at the current dataPosition(). Returns null if the previously written Bundle object was null.
readPersistableBundle
fun readPersistableBundle(loader: ClassLoader?): PersistableBundle?
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. Returns null if the previously written Bundle object was null.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
readSerializable
funreadSerializable(): Serializable?
Deprecated: Use the type-safer version readSerializable(java.lang.ClassLoader,java.lang.Class)
starting from Android Build.VERSION_CODES#TIRAMISU
.
Read and return a new Serializable object from the parcel.
Return | |
---|---|
Serializable? |
the Serializable object, or null if the Serializable name wasn't found in the parcel. Unlike readSerializable(java.lang.ClassLoader,java.lang.Class) , it uses the nearest valid class loader up the execution stack to instantiate the Serializable object. |
readSerializable
fun <T : Any!> readSerializable(
loader: ClassLoader?,
clazz: Class<T>
): T?
Same as readSerializable()
but accepts loader
and clazz
parameters.
Parameters | |
---|---|
loader |
ClassLoader?: A ClassLoader from which to instantiate the Serializable object, or null for the default class loader. |
clazz |
Class<T>: The type of the object expected. This value cannot be null . |
Return | |
---|---|
T? |
This value may be null . |
Exceptions | |
---|---|
android.os.BadParcelableException |
Throws BadParcelableException if the item to be deserialized is not an instance of that class or any of its children class or there there was an error deserializing the object. |
readSize
fun readSize(): Size
Read a Size from the parcel at the current dataPosition().
Return | |
---|---|
Size |
This value cannot be null . |
readSizeF
fun readSizeF(): SizeF
Read a SizeF from the parcel at the current dataPosition().
Return | |
---|---|
SizeF |
This value cannot be null . |
readSparseArray
fun <T : Any!>readSparseArray(loader: ClassLoader?): SparseArray<T>?
Deprecated: Use the type-safer version readSparseArray(java.lang.ClassLoader,java.lang.Class)
starting from Android Build.VERSION_CODES#TIRAMISU
. Also consider changing the format to use 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.
Read and return a new SparseArray 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.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
readSparseArray
fun <T : Any!> readSparseArray(
loader: ClassLoader?,
clazz: Class<out T>
): SparseArray<T>?
Same as readSparseArray(java.lang.ClassLoader)
but accepts clazz
parameter as the type required for each item.
Warning: if the list contains items implementing the Parcelable
interface, the class that implements Parcelable
has to be the immediately enclosing class of the runtime type of its CREATOR field (that is, 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 readSparseArray(java.lang.ClassLoader)
instead.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
clazz |
Class<out T>: This value cannot be null . |
Return | |
---|---|
SparseArray<T>? |
This value may be null . |
Exceptions | |
---|---|
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. |
readSparseBooleanArray
fun readSparseBooleanArray(): SparseBooleanArray?
Read and return a new SparseBooleanArray object from the parcel at the current dataPosition(). Returns null if the previously written list object was null.
readString
fun readString(): String?
Read a string value from the parcel at the current dataPosition().
Return | |
---|---|
String? |
This value may be null . |
readStringArray
fun readStringArray(val: Array<String!>): Unit
Parameters | |
---|---|
val |
Array<String!>: This value cannot be null . |
readStringList
fun readStringList(list: MutableList<String!>): Unit
Read into the given List items String objects that were written with writeStringList
at the current dataPosition().
Parameters | |
---|---|
list |
MutableList<String!>: This value cannot be null . |
See Also
readStrongBinder
fun readStrongBinder(): IBinder!
Read an object from the parcel at the current dataPosition().
readTypedArray
fun <T : Any!> readTypedArray(
val: Array<T>,
c: Parcelable.Creator<T>
): Unit
Parameters | |
---|---|
val |
Array<T>: This value cannot be null . |
c |
Parcelable.Creator<T>: This value cannot be null . |
readTypedList
fun <T : Any!> readTypedList(
list: MutableList<T>,
c: Parcelable.Creator<T>
): Unit
Read into the given List items containing a particular object type that were written with #writeTypedList at the current dataPosition(). The list must have previously been written via #writeTypedList with the same object type.
Parameters | |
---|---|
list |
MutableList<T>: This value cannot be null . |
c |
Parcelable.Creator<T>: This value cannot be null . |
See Also
readTypedObject
fun <T : Any!> readTypedObject(c: Parcelable.Creator<T>): T?
Read and return a typed Parcelable object from a parcel. Returns null if the previous written object was null. The object must have previous been written via writeTypedObject
with the same object type.
Parameters | |
---|---|
c |
Parcelable.Creator<T>: This value cannot be null . |
Return | |
---|---|
T? |
A newly created object of the type that was previously written. |
See Also
readValue
fun readValue(loader: ClassLoader?): Any?
Read a typed object from a parcel. The given class loader will be used to load any enclosed Parcelables. If it is null, the default class loader will be used.
Parameters | |
---|---|
loader |
ClassLoader?: This value may be null . |
recycle
fun recycle(): Unit
Put a Parcel object back into the pool. You must not touch the object after this call.
setDataCapacity
fun setDataCapacity(size: Int): Unit
Change the capacity (current available space) of the parcel.
Parameters | |
---|---|
size |
Int: The new capacity of the parcel, in bytes. Can not be less than dataSize -- that is, you can not drop existing data with this method. |
setDataPosition
fun setDataPosition(pos: Int): Unit
Move the current read/write position in the parcel.
Parameters | |
---|---|
pos |
Int: New offset in the parcel; must be between 0 and dataSize . |
setDataSize
fun setDataSize(size: Int): Unit
Change the amount of data in the parcel. Can be either smaller or larger than the current size. If larger than the current capacity, more memory will be allocated.
Parameters | |
---|---|
size |
Int: The new number of bytes in the Parcel. |
setPropagateAllowBlocking
fun setPropagateAllowBlocking(): Unit
This method is used by the AIDL compiler for system components. Not intended to be used by non-system apps.
unmarshall
fun unmarshall(
data: ByteArray,
offset: Int,
length: Int
): Unit
Fills the raw bytes of this Parcel with the supplied data.
Parameters | |
---|---|
data |
ByteArray: This value cannot be null . |
writeArray
fun writeArray(val: Array<Any!>?): Unit
Flatten an Object array into the parcel at the current dataPosition(), growing dataCapacity() if needed. The array values are written using writeValue
and must follow the specification there.
Parameters | |
---|---|
val |
Array<Any!>?: This value may be null . |
writeBinderArray
fun writeBinderArray(val: Array<IBinder!>?): Unit
Parameters | |
---|---|
val |
Array<IBinder!>?: This value may be null . |
writeBinderList
fun writeBinderList(val: MutableList<IBinder!>?): Unit
Flatten a List containing IBinder objects into the parcel, at the current dataPosition() and growing dataCapacity() if needed. They can later be retrieved with createBinderArrayList
or readBinderList
.
Parameters | |
---|---|
val |
MutableList<IBinder!>?: The list of strings to be written. This value may be null . |
See Also
writeBlob
fun writeBlob(b: ByteArray?): Unit
Write a blob of data into the parcel at the current dataPosition
, growing dataCapacity
if needed.
If the blob is small, then it is stored in-place, otherwise it is transferred by way of an anonymous shared memory region. If you prefer send in-place, please use writeByteArray(byte[])
.
Parameters | |
---|---|
b |
ByteArray?: Bytes to place into the parcel. This value may be null . |
See Also
writeBlob
fun writeBlob(
b: ByteArray?,
offset: Int,
len: Int
): Unit
Write a blob of data into the parcel at the current dataPosition
, growing dataCapacity
if needed.
If the blob is small, then it is stored in-place, otherwise it is transferred by way of an anonymous shared memory region. If you prefer send in-place, please use writeByteArray(byte[],int,int)
.
Parameters | |
---|---|
b |
ByteArray?: Bytes to place into the parcel. This value may be null . |
offset |
Int: Index of first byte to be written. |
len |
Int: Number of bytes to write. |
See Also
writeBoolean
fun writeBoolean(val: Boolean): Unit
Write a boolean value into the parcel at the current dataPosition(), growing dataCapacity() if needed.
Note: This method currently delegates to writeInt with a value of 1 or 0 for true or false, respectively, but may change in the future.
writeBooleanArray
fun writeBooleanArray(val: BooleanArray?): Unit
Parameters | |
---|---|
val |
BooleanArray?: This value may be null . |
writeBundle
fun writeBundle(val: Bundle?): Unit
Flatten a Bundle into the parcel at the current dataPosition(), growing dataCapacity() if needed.
Parameters | |
---|---|
val |
Bundle?: This value may be null . |
writeByte
fun writeByte(val: Byte): Unit
Write a byte value into the parcel at the current dataPosition(), growing dataCapacity() if needed.
Note: This method currently delegates to writeInt but may change in the future.
writeByteArray
fun writeByteArray(b: ByteArray?): Unit
Write a byte array into the parcel at the current dataPosition
, growing dataCapacity
if needed.
Parameters | |
---|---|
b |
ByteArray?: Bytes to place into the parcel. This value may be null . |
writeByteArray
fun writeByteArray(
b: ByteArray?,
offset: Int,
len: Int
): Unit
Write a byte array into the parcel at the current dataPosition
, growing dataCapacity
if needed.
Parameters | |
---|---|
b |
ByteArray?: Bytes to place into the parcel. This value may be null . |
offset |
Int: Index of first byte to be written. |
len |
Int: Number of bytes to write. |
writeCharArray
fun writeCharArray(val: CharArray?): Unit
Parameters | |
---|---|
val |
CharArray?: This value may be null . |
writeDouble
fun writeDouble(val: Double): Unit
Write a double precision floating point value into the parcel at the current dataPosition(), growing dataCapacity() if needed.
writeDoubleArray
fun writeDoubleArray(val: DoubleArray?): Unit
Parameters | |
---|---|
val |
DoubleArray?: This value may be null . |
writeException
fun writeException(e: Exception): Unit
Special function for writing an exception result at the header of a parcel, to be used when returning an exception from a transaction. Note that this currently only supports a few exception types; any other exception will be re-thrown by this function as a RuntimeException (to be caught by the system's last-resort exception handling when dispatching a transaction).
The supported exception types are:
BadParcelableException
IllegalArgumentException
IllegalStateException
NullPointerException
SecurityException
UnsupportedOperationException
NetworkOnMainThreadException
Parameters | |
---|---|
e |
Exception: The Exception to be written. This value cannot be null . |
See Also
writeFileDescriptor
fun writeFileDescriptor(val: FileDescriptor): Unit
Write a FileDescriptor into the parcel at the current dataPosition(), growing dataCapacity() if needed.
The file descriptor will not be closed, which may result in file descriptor leaks when objects are returned from Binder calls. Use ParcelFileDescriptor#writeToParcel
instead, which accepts contextual flags and will close the original file descriptor if Parcelable#PARCELABLE_WRITE_RETURN_VALUE
is set.
Parameters | |
---|---|
val |
FileDescriptor: This value cannot be null . |
writeFixedArray
fun <T : Any!> writeFixedArray(
val: T?,
parcelableFlags: Int,
vararg dimensions: Int
): Unit
Flatten a homogeneous multi-dimensional array with fixed-size. This delegates to other APIs to write a one-dimensional array. Use readFixedArray(java.lang.Object)
or createFixedArray(java.lang.Class,int[])
with the same dimensions to unmarshal.
Parameters | |
---|---|
val |
T?: The array to be written. This value may be null . |
parcelableFlags |
Int: Contextual flags as per Parcelable.writeToParcel() . Used only if val is an array of Parcelable objects. |
dimensions |
Int: an array of int representing length of each dimension. The array should be sized with the exact size of dimensions. This value cannot be null . |
Exceptions | |
---|---|
android.os.BadParcelableException |
If the array's component type is not supported or if its size doesn't match with the given dimensions. |
writeFloat
fun writeFloat(val: Float): Unit
Write a floating point value into the parcel at the current dataPosition(), growing dataCapacity() if needed.
writeFloatArray
fun writeFloatArray(val: FloatArray?): Unit
Parameters | |
---|---|
val |
FloatArray?: This value may be null . |
writeInt
fun writeInt(val: Int): Unit
Write an integer value into the parcel at the current dataPosition(), growing dataCapacity() if needed.
writeIntArray
fun writeIntArray(val: IntArray?): Unit
Parameters | |
---|---|
val |
IntArray?: This value may be null . |
writeInterfaceArray
fun <T : IInterface!> writeInterfaceArray(val: Array<T>?): Unit
Flatten a homogeneous array containing an IInterface type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. The type of the objects in the array must be one that implements IInterface.
Parameters | |
---|---|
val |
Array<T>?: The array of objects to be written. This value may be null . |
writeInterfaceList
fun <T : IInterface!> writeInterfaceList(val: MutableList<T>?): Unit
Flatten a List
containing T (IInterface) objects into this parcel at the current position. They can later be retrieved with createInterfaceArrayList
or readInterfaceList
.
Parameters | |
---|---|
val |
MutableList<T>?: This value may be null . |
writeInterfaceToken
fun writeInterfaceToken(interfaceName: String): Unit
Store or read an IBinder interface token in the parcel at the current dataPosition
. This is used to validate that the marshalled transaction is intended for the target interface. This is typically written at the beginning of transactions as a header.
Parameters | |
---|---|
interfaceName |
String: This value cannot be null . |
writeList
fun writeList(val: MutableList<Any?>?): Unit
Flatten a List into the parcel at the current dataPosition(), growing dataCapacity() if needed. The List values are written using writeValue
and must follow the specification there.
Parameters | |
---|---|
val |
MutableList<Any?>?: This value may be null . |
writeLong
fun writeLong(val: Long): Unit
Write a long integer value into the parcel at the current dataPosition(), growing dataCapacity() if needed.
writeLongArray
fun writeLongArray(val: LongArray?): Unit
Parameters | |
---|---|
val |
LongArray?: This value may be null . |
writeMap
fun writeMap(val: MutableMap<Any?, Any?>?): Unit
Please use writeBundle
instead. Flattens a Map into the parcel at the current dataPosition(), growing dataCapacity() if needed. The Map keys must be String objects. The Map values are written using writeValue
and must follow the specification there.
It is strongly recommended to use writeBundle
instead of this method, since the Bundle class provides a type-safe API that allows you to avoid mysterious type errors at the point of marshalling.
Parameters | |
---|---|
val |
MutableMap<Any?, Any?>?: This value may be null . |
writeNoException
fun writeNoException(): Unit
Special function for writing information at the front of the Parcel indicating that no exception occurred.
See Also
writeParcelable
fun writeParcelable(
p: Parcelable?,
parcelableFlags: Int
): Unit
Flatten the name of the class of the Parcelable and its contents into the parcel.
Parameters | |
---|---|
p |
Parcelable?: The Parcelable object to be written. This value may be null . |
parcelableFlags |
Int: Contextual flags as per Parcelable.writeToParcel() . |
writeParcelableArray
fun <T : Parcelable!> writeParcelableArray(
value: Array<T>?,
parcelableFlags: Int
): Unit
Write a heterogeneous array of Parcelable objects into the Parcel. Each object in the array is written along with its class name, so that the correct class can later be instantiated. As a result, this has significantly more overhead than writeTypedArray
, but will correctly handle an array containing more than one type of object.
Parameters | |
---|---|
value |
Array<T>?: The array of objects to be written. This value may be null . |
parcelableFlags |
Int: Contextual flags as per Parcelable.writeToParcel() . |
See Also
writeParcelableCreator
fun writeParcelableCreator(p: Parcelable): Unit
Flatten the name of the class of the Parcelable into this Parcel.
Parameters | |
---|---|
p |
Parcelable: The Parcelable object to be written. This value cannot be null . |
See Also
writeParcelableList
fun <T : Parcelable!> writeParcelableList(
val: MutableList<T>?,
flags: Int
): Unit
Flatten a List
containing arbitrary Parcelable
objects into this parcel at the current position. They can later be retrieved using readParcelableList(java.util.List,java.lang.ClassLoader)
if required.
Parameters | |
---|---|
val |
MutableList<T>?: This value may be null . |
writePersistableBundle
fun writePersistableBundle(val: PersistableBundle?): Unit
Flatten a PersistableBundle into the parcel at the current dataPosition(), growing dataCapacity() if needed.
Parameters | |
---|---|
val |
PersistableBundle?: This value may be null . |
writeSerializable
fun writeSerializable(s: Serializable?): Unit
Write a generic serializable object in to a Parcel. It is strongly recommended that this method be avoided, since the serialization overhead is extremely large, and this approach will be much slower than using the other approaches to writing data in to a Parcel.
Parameters | |
---|---|
s |
Serializable?: This value may be null . |
writeSize
fun writeSize(val: Size): Unit
Flatten a Size into the parcel at the current dataPosition(), growing dataCapacity() if needed.
Parameters | |
---|---|
val |
Size: This value cannot be null . |
writeSizeF
fun writeSizeF(val: SizeF): Unit
Flatten a SizeF into the parcel at the current dataPosition(), growing dataCapacity() if needed.
Parameters | |
---|---|
val |
SizeF: This value cannot be null . |
writeSparseArray
fun <T : Any!> writeSparseArray(val: SparseArray<T>?): Unit
Flatten a generic SparseArray into the parcel at the current dataPosition(), growing dataCapacity() if needed. The SparseArray values are written using writeValue
and must follow the specification there.
Parameters | |
---|---|
val |
SparseArray<T>?: This value may be null . |
writeSparseBooleanArray
fun writeSparseBooleanArray(val: SparseBooleanArray?): Unit
Parameters | |
---|---|
val |
SparseBooleanArray?: This value may be null . |
writeString
fun writeString(val: String?): Unit
Write a string value into the parcel at the current dataPosition(), growing dataCapacity() if needed.
Parameters | |
---|---|
val |
String?: This value may be null . |
writeStringArray
fun writeStringArray(val: Array<String!>?): Unit
Parameters | |
---|---|
val |
Array<String!>?: This value may be null . |
writeStringList
fun writeStringList(val: MutableList<String!>?): Unit
Flatten a List containing String objects into the parcel, at the current dataPosition() and growing dataCapacity() if needed. They can later be retrieved with createStringArrayList
or readStringList
.
Parameters | |
---|---|
val |
MutableList<String!>?: The list of strings to be written. This value may be null . |
See Also
writeStrongBinder
fun writeStrongBinder(val: IBinder!): Unit
Write an object into the parcel at the current dataPosition(), growing dataCapacity() if needed.
writeStrongInterface
fun writeStrongInterface(val: IInterface!): Unit
Write an object into the parcel at the current dataPosition(), growing dataCapacity() if needed.
writeTypedArray
fun <T : Parcelable!> writeTypedArray(
val: Array<T>?,
parcelableFlags: Int
): Unit
Flatten a homogeneous array containing a particular object type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. The type of the objects in the array must be one that implements Parcelable. Unlike the writeParcelableArray
method, however, only the raw data of the objects is written and not their type, so you must use readTypedArray
with the correct corresponding Parcelable.Creator
implementation to unmarshall them.
Parameters | |
---|---|
val |
Array<T>?: The array of objects to be written. This value may be null . |
parcelableFlags |
Int: Contextual flags as per Parcelable.writeToParcel() . |
writeTypedArrayMap
fun <T : Parcelable!> writeTypedArrayMap(
val: ArrayMap<String!, T>?,
parcelableFlags: Int
): Unit
Flatten an ArrayMap
with string keys containing a particular object type into the parcel at the current dataPosition() and growing dataCapacity() if needed. The type of the objects in the array must be one that implements Parcelable. Only the raw data of the objects is written and not their type, so you must use the corresponding createTypedArrayMap(android.os.Parcelable.Creator)
Parameters | |
---|---|
val |
ArrayMap<String!, T>?: The map of objects to be written. This value may be null . |
parcelableFlags |
Int: The parcelable flags to use. |
writeTypedList
fun <T : Parcelable!> writeTypedList(val: MutableList<T>?): Unit
Flatten a List containing a particular object type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. The type of the objects in the list must be one that implements Parcelable. Unlike the generic writeList() method, however, only the raw data of the objects is written and not their type, so you must use the corresponding readTypedList() to unmarshall them.
Parameters | |
---|---|
val |
MutableList<T>?: The list of objects to be written. This value may be null . |
writeTypedList
fun <T : Parcelable!> writeTypedList(
val: MutableList<T>?,
parcelableFlags: Int
): Unit
Flatten a List containing a particular object type into the parcel, at the current dataPosition() and growing dataCapacity() if needed. The type of the objects in the list must be one that implements Parcelable. Unlike the generic writeList() method, however, only the raw data of the objects is written and not their type, so you must use the corresponding readTypedList() to unmarshall them.
Parameters | |
---|---|
val |
MutableList<T>?: The list of objects to be written. This value may be null . |
parcelableFlags |
Int: Contextual flags as per Parcelable.writeToParcel() . |
writeTypedObject
fun <T : Parcelable!> writeTypedObject(
val: T?,
parcelableFlags: Int
): Unit
Flatten the Parcelable object into the parcel.
Parameters | |
---|---|
val |
T?: The Parcelable object to be written. This value may be null . |
parcelableFlags |
Int: Contextual flags as per Parcelable.writeToParcel() . |
See Also
writeTypedSparseArray
fun <T : Parcelable!> writeTypedSparseArray(
val: SparseArray<T>?,
parcelableFlags: Int
): Unit
Flatten a SparseArray
containing a particular object type into the parcel at the current dataPosition() and growing dataCapacity() if needed. The type of the objects in the array must be one that implements Parcelable. Unlike the generic writeSparseArray(android.util.SparseArray)
method, however, only the raw data of the objects is written and not their type, so you must use the corresponding createTypedSparseArray(android.os.Parcelable.Creator)
.
Parameters | |
---|---|
val |
SparseArray<T>?: The list of objects to be written. This value may be null . |
parcelableFlags |
Int: The parcelable flags to use. |
writeValue
fun writeValue(v: Any?): Unit
Flatten a generic object in to a parcel. The given Object value may currently be one of the following types:
- null
- String
- Byte
- Short
- Integer
- Long
- Float
- Double
- Boolean
- String[]
- boolean[]
- byte[]
- int[]
- long[]
- Object[] (supporting objects of the same type defined here).
-
Bundle
- Map (as supported by
writeMap
). - Any object that implements the
Parcelable
protocol. - Parcelable[]
- CharSequence (as supported by
TextUtils#writeToParcel
). - List (as supported by
writeList
). -
SparseArray
(as supported bywriteSparseArray(android.util.SparseArray)
). -
IBinder
- Any object that implements Serializable (but see
writeSerializable
for caveats). Note that all of the previous types have relatively efficient implementations for writing to a Parcel; having to rely on the generic serialization approach is much less efficient and should be avoided whenever possible.
Parcelable
objects are written with Parcelable#writeToParcel
using contextual flags of 0. When serializing objects containing ParcelFileDescriptor
s, this may result in file descriptor leaks when they are returned from Binder calls (where Parcelable#PARCELABLE_WRITE_RETURN_VALUE
should be used).
Parameters | |
---|---|
v |
Any?: This value may be null . |
Protected methods
finalize
protected fun finalize(): Unit
Exceptions | |
---|---|
java.lang.Throwable |
the Exception raised by this method |