SimPhonebookContract.ElementaryFiles

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

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.