Added in API level 31

Summary: Constants | Fields | Methods | Inherited Methods

SimPhonebookContract.ElementaryFiles

Kotlin |Java

public static final class SimPhonebookContract.ElementaryFiles
extends Object

java.lang.Object
↳	android.provider.SimPhonebookContract.ElementaryFiles

Constants for metadata about the elementary files of the SIM cards in the phone.

Operations

Insert

Insert is not supported for the Uris defined in this class.

Update

Update is not supported for the Uris defined in this class.

Delete

Delete is not supported for the Uris defined in this class.

Query

The elementary files for all the inserted SIMs can be read via ElementaryFiles.CONTENT_URI. Unsupported elementary files are omitted from the results. This Uri always returns all supported elementary files for all available SIMs; it does not support filtering via a selection. A specific elementary file can be queried via a Uri returned by ElementaryFiles.getItemUri(int, int). If the elementary file referenced by this Uri is unsupported by the SIM then the query will return an empty cursor.

Summary

Constants
`String`	`CONTENT_ITEM_TYPE` The MIME type of a CONTENT_URI subdirectory of a single ADN-like elementary file.
`String`	`CONTENT_TYPE` The MIME type of CONTENT_URI providing a directory of ADN-like elementary files.
`int`	`EF_ADN` Type for accessing records in the "abbreviated dialing number" (ADN) elementary file on the SIM.
`int`	`EF_FDN` Type for accessing records in the "fixed dialing number" (FDN) elementary file on the SIM.
`int`	`EF_SDN` Type for accessing records in the "service dialing number" (SDN) elementary file on the SIM.
`String`	`EF_TYPE` The elementary file type for this row.
`int`	`EF_UNKNOWN` A value for an elementary file that is not recognized.
`String`	`MAX_RECORDS` The maximum number of records supported by the elementary file.
`String`	`NAME_MAX_LENGTH` The maximum length supported for the name of a record in the elementary file.
`String`	`PHONE_NUMBER_MAX_LENGTH` The maximum length supported for the phone number of a record in the elementary file.
`String`	`RECORD_COUNT` Count of the number of records that are currently stored in the elementary file.
`String`	`SLOT_INDEX` `SubscriptionInfo.getSimSlotIndex()` of the SIM for this row.
`String`	`SUBSCRIPTION_ID` `SubscriptionInfo.getSubscriptionId()` of the SIM for this row.

Fields
`public static final Uri`	`CONTENT_URI` Content URI for the ADN-like elementary files available on the device.

Public methods
`static Uri`	`getItemUri(int subscriptionId, int efType)` Returns a content uri for a specific elementary file.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long 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`	`wait(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`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

CONTENT_ITEM_TYPE

Added in API level 31

public static final String CONTENT_ITEM_TYPE

The MIME type of a CONTENT_URI subdirectory of a single ADN-like elementary file.

Constant Value: "vnd.android.cursor.item/sim-elementary-file"

CONTENT_TYPE

Added in API level 31

public static final String CONTENT_TYPE

The MIME type of CONTENT_URI providing a directory of ADN-like elementary files.

Constant Value: "vnd.android.cursor.dir/sim-elementary-file"

EF_ADN

Added in API level 31

public static final int EF_ADN

Type for accessing records in the "abbreviated dialing number" (ADN) elementary file on the SIM.

ADN records are typically user created.

Constant Value: 1 (0x00000001)

EF_FDN

Added in API level 31

public static final int EF_FDN

Type for accessing records in the "fixed dialing number" (FDN) elementary file on the SIM.

FDN numbers are the numbers that are allowed to dialed for outbound calls when FDN is enabled.

FDN records cannot be modified by applications. Hence, insert, update and delete methods operating on this Uri will throw UnsupportedOperationException

Constant Value: 2 (0x00000002)

EF_SDN

Added in API level 31

public static final int EF_SDN

Type for accessing records in the "service dialing number" (SDN) elementary file on the SIM.

Typically SDNs are preset numbers provided by the carrier for common operations (e.g. voicemail, check balance, etc).

SDN records cannot be modified by applications. Hence, insert, update and delete methods operating on this Uri will throw UnsupportedOperationException

Constant Value: 3 (0x00000003)

EF_TYPE

Added in API level 31

public static final String EF_TYPE

The elementary file type for this row.

See also:

Constant Value: "ef_type"

EF_UNKNOWN

Added in API level 31

public static final int EF_UNKNOWN

A value for an elementary file that is not recognized.

Generally this should be ignored. If new values are added then this will be used for apps that target SDKs where they aren't defined.

Constant Value: 0 (0x00000000)

MAX_RECORDS

Added in API level 31

public static final String MAX_RECORDS

The maximum number of records supported by the elementary file.

Constant Value: "max_records"

NAME_MAX_LENGTH

Added in API level 31

public static final String NAME_MAX_LENGTH

The maximum length supported for the name of a record in the elementary file.

Constant Value: "name_max_length"

PHONE_NUMBER_MAX_LENGTH

Added in API level 31

public static final String PHONE_NUMBER_MAX_LENGTH

The maximum length supported for the phone number of a record in the elementary file.

Constant Value: "phone_number_max_length"

RECORD_COUNT

Added in API level 31

public static final String RECORD_COUNT

Count of the number of records that are currently stored in the elementary file.

Constant Value: "record_count"

SLOT_INDEX

Added in API level 31

public static final String SLOT_INDEX

SubscriptionInfo.getSimSlotIndex() of the SIM for this row.

Constant Value: "slot_index"

SUBSCRIPTION_ID

Added in API level 31

public static final String SUBSCRIPTION_ID

SubscriptionInfo.getSubscriptionId() of the SIM for this row.

Constant Value: "subscription_id"

Fields

CONTENT_URI

Added in API level 31

public static final Uri CONTENT_URI

Content URI for the ADN-like elementary files available on the device.

Public methods

getItemUri

Added in API level 31

public static Uri getItemUri (int subscriptionId, 
                int efType)

Returns a content uri for a specific elementary file.

If a SIM with the specified subscriptionId is not present an exception will be thrown. If the SIM doesn't support the specified elementary file it will return an empty cursor.

Parameters
`subscriptionId`	`int`
`efType`	`int`: Value is `EF_UNKNOWN`, `EF_ADN`, `EF_FDN`, or `EF_SDN`

Returns
`Uri`	This value cannot be `null`.