Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QRecordBasedSimFile Class Reference
[QtTelephonyModule]

The QRecordBasedSimFile class provides an interface to access record-based files on a SIM. More...

    #include <QRecordBasedSimFile>

Inherits QObject.

• List of all members, including inherited members

Public Functions

• QRecordBasedSimFile ( const QString & fileid, const QString & service = QString(), QObject * parent = 0 )
• ~QRecordBasedSimFile ()
• void read ( int recno, int recordSize = -1 )
• void requestFileInfo ()
• void write ( int recno, const char * data, int len )
• void write ( int recno, const QByteArray & data )

• 29 public functions inherited from QObject

Signals

• void error ( QTelephony::SimFileError err )
• void fileInfo ( int numRecords, int recordSize )
• void readDone ( const QByteArray & data, int recno )
• void writeDone ( int recno )

• 1 signal inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The QRecordBasedSimFile class provides an interface to access record-based files on a SIM.

This interface is typically used to access auxiliary information on a SIM such as icons, extended address book attributes, MMS settings, etc.

This class can only be used on record-based SIM files. For binary SIM files, use QBinarySimFile instead.

Record-based SIM files are usually limited in size to 255 records. Attempting to read beyond this boundary will result in an error. Records are also typically limited to no more than 256 bytes.

Consult 3GPP TS 11.11 and 3GPP TS 51.011 for more information on the format of individual SIM files.

See also QBinarySimFile and QSimFiles.

Member Function Documentation

QRecordBasedSimFile::QRecordBasedSimFile ( const QString & fileid, const QString & service = QString(), QObject * parent = 0 )

Create a record-based SIM file access object for fileid and attach it to parent. The service parameter indicates the telephony service to use to access the file, or an empty string to use the default service.

For example, 6F3C indicates the EFsms file.

The fileid should be the complete hexadecimal path to the file on the SIM. For example, the EFsms file is numbered 6F3C underneath the DFtelecom directory (7F10). Therefore, fileid should be 7F106F3C.

QRecordBasedSimFile::~QRecordBasedSimFile ()

Destroy this record-based SIM file access object.

void QRecordBasedSimFile::error ( QTelephony::SimFileError err )   [signal]

Signal that is emitted if an error err occurred while reading or writing this record-based file.

See also read() and write().

void QRecordBasedSimFile::fileInfo ( int numRecords, int recordSize )   [signal]

Signal that is emitted when the file information for this record-based file is returned. The number of records in the file is numRecords, and the size of individual records is recordSize bytes.

See also requestFileInfo().

void QRecordBasedSimFile::read ( int recno, int recordSize = -1 )

Request that a single record be read from this record-based file at position recno. The data will be returned in a readDone() signal. Record numbers begin at zero.

If recordSize is not -1, it indicates that the record size is already known. Otherwise the service will determine the record size for itself.

See also readDone() and write().

void QRecordBasedSimFile::readDone ( const QByteArray & data, int recno )   [signal]

Signal that is emitted when a read from record recno of this record-based file completes. The data parameter contains the data that was read from the file.

See also read().

void QRecordBasedSimFile::requestFileInfo ()

Request the number of records and record size for this record-based file. The value will be returned in a fileInfo() signal.

See also fileInfo().

void QRecordBasedSimFile::write ( int recno, const char * data, int len )

Write len bytes of data to position record recno in this record-based file. The writeDone() signal will be emitted once the write completes. Record numbers begin at zero.

See also writeDone() and read().

void QRecordBasedSimFile::write ( int recno, const QByteArray & data )

This is an overloaded member function, provided for convenience.

Write data to record recno in this record-based file. The writeDone() signal will be emitted once the write completes.

See also writeDone() and read().

void QRecordBasedSimFile::writeDone ( int recno )   [signal]

Signal that is emitted when a write to record recno of this record-based file completes.

See also write().