File	Doc	Category	Size	Date	Package
ComprehensionTlv.java	API Doc	Android 1.5 API	5593	Wed May 06 22:42:02 BST 2009	com.android.internal.telephony.gsm.stk

ComprehensionTlv

• java.lang.Object

Fields Summary
private int	mTag
private boolean	mCr
private int	mLength
private int	mValueIndex
private byte[]	mRawValue

Constructors Summary

protected ComprehensionTlv(int tag, boolean cr, int length, byte[] data, int valueIndex) Constructor. Private on purpose. Use {@link #decodeMany(byte[], int) decodeMany} or {@link #decode(byte[], int) decode} method. param tag The tag for this object param cr Comprehension Required flag param length Length of the value param data Byte array containing the value param valueIndex Index in data at which the value starts mTag = tag; mCr = cr; mLength = length; mValueIndex = valueIndex; mRawValue = data;

Methods Summary
public static com.android.internal.telephony.gsm.stk.ComprehensionTlv	decode(byte[] data, int startIndex) Parses an COMPREHENSION-TLV object from a byte array. param data A byte array containing data to be parsed param startIndex Index in data at which to start parsing return A COMPREHENSION-TLV object parsed throws ResultException try { int curIndex = startIndex; int endIndex = data.length; /* tag */ int tag; boolean cr; // Comprehension required flag int temp = data[curIndex++] & 0xff; switch (temp) { case 0: case 0xff: case 0x80: throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); case 0x7f: // tag is in three-byte format tag = ((data[curIndex] & 0xff) << 8) | (data[curIndex + 1] & 0xff); cr = (tag & 0x8000) != 0; tag &= ~0x8000; curIndex += 2; break; default: // tag is in single-byte format tag = temp; cr = (tag & 0x80) != 0; tag &= ~0x80; break; } /* length */ int length; temp = data[curIndex++] & 0xff; if (temp < 0x80) { length = temp; } else if (temp == 0x81) { length = data[curIndex++] & 0xff; if (length < 0x80) { throw new ResultException( ResultCode.CMD_DATA_NOT_UNDERSTOOD); } } else if (temp == 0x82) { length = ((data[curIndex] & 0xff) << 8) | (data[curIndex + 1] & 0xff); curIndex += 2; if (length < 0x100) { throw new ResultException( ResultCode.CMD_DATA_NOT_UNDERSTOOD); } } else if (temp == 0x83) { length = ((data[curIndex] & 0xff) << 16) | ((data[curIndex + 1] & 0xff) << 8) | (data[curIndex + 2] & 0xff); curIndex += 3; if (length < 0x10000) { throw new ResultException( ResultCode.CMD_DATA_NOT_UNDERSTOOD); } } else { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); } return new ComprehensionTlv(tag, cr, length, data, curIndex); } catch (IndexOutOfBoundsException e) { throw new ResultException(ResultCode.CMD_DATA_NOT_UNDERSTOOD); }
public static java.util.List	decodeMany(byte[] data, int startIndex) Parses a list of COMPREHENSION-TLV objects from a byte array. param data A byte array containing data to be parsed param startIndex Index in data at which to start parsing return A list of COMPREHENSION-TLV objects parsed throws ResultException ArrayList<ComprehensionTlv> items = new ArrayList<ComprehensionTlv>(); int endIndex = data.length; while (startIndex < endIndex) { ComprehensionTlv ctlv = ComprehensionTlv.decode(data, startIndex); items.add(ctlv); startIndex = ctlv.mValueIndex + ctlv.mLength; } return items;
public int	getLength() return mLength;
public byte[]	getRawValue() return mRawValue;
public int	getTag() return mTag;
public int	getValueIndex() return mValueIndex;
public boolean	isComprehensionRequired() return mCr;