sl@0: // Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // Resource reader
sl@0: // 
sl@0: //
sl@0: 
sl@0: #include "BaRsReadImpl.h"
sl@0: #include "BaCompileAssert.h"
sl@0: 
sl@0: /** @internalComponent
sl@0: An error will be issued at compile time if the class size is not KRsReaderImplSize. */
sl@0: TResourceReaderImpl::TResourceReaderImpl() :
sl@0:     iBuffer(NULL),
sl@0:     iCurrentPtr(NULL)
sl@0: 	{
sl@0: 	//TResourceReaderImpl size. It should be 12 because of the BC reasons.
sl@0: 	//12 is the size of TResourceReader class.
sl@0: 	enum
sl@0: 		{
sl@0: 		KRsReaderImplSize = 12
sl@0: 		};
sl@0: 	COMPILE_TIME_ASSERT(sizeof(TResourceReaderImpl) == KRsReaderImplSize);
sl@0: 	}
sl@0: 
sl@0: /** Sets the buffer containing the resource data.
sl@0: 
sl@0: The current position within the buffer is set to the start of the buffer so 
sl@0: that subsequent calls to the interpreting functions, for example ReadInt8(), 
sl@0: start at the beginning of this buffer.
sl@0: 
sl@0: @internalComponent
sl@0: @param aBuffer Pointer to an 8 bit non-modifiable descriptor containing 
sl@0: or representing resource data.
sl@0: @param aResourceId The numeric id of the resource to be read.
sl@0: @post Buffer pointer is initialized.
sl@0: @post Buffer current position pointer is initialized. */
sl@0: void TResourceReaderImpl::SetBuffer(const TDesC8* aBuffer)
sl@0: 	{
sl@0: 	iBuffer=aBuffer;
sl@0: 	iCurrentPtr=iBuffer->Ptr();
sl@0: 	}
sl@0: 
sl@0: /** Sets the buffer and current position to NULL.
sl@0: @internalComponent
sl@0: @post Buffer pointer is set to NULL.
sl@0: @post Buffer current position pointer is set to NULL. */
sl@0: void TResourceReaderImpl::ResetBuffer()
sl@0: 	{
sl@0: 	iBuffer=NULL;
sl@0: 	iCurrentPtr=NULL;
sl@0: 	}
sl@0: 
sl@0: /** Returns the current position within the resource buffer. 
sl@0: 
sl@0: The function makes no assumption about the type of data in the buffer at the 
sl@0: current position.
sl@0: 
sl@0: @internalComponent
sl@0: @return A pointer to the current position within the resource buffer. */
sl@0: const TAny* TResourceReaderImpl::Ptr()
sl@0:     {
sl@0:     return(iCurrentPtr);
sl@0:     }
sl@0: 
sl@0: /** Updates iCurrentPtr with a new value.
sl@0: 
sl@0: @internalComponent
sl@0: @pre iBuffer is not NULL.
sl@0: @pre aPtr is not NULL.
sl@0: @param aPtr The new value of iCurrentPtr.
sl@0: @post iCurrentPtr is updated.
sl@0: @panic BAFL 4 The new iCurrentPtr points beyond the buffer end.
sl@0: @panic BAFL 70 iBuffer is NULL. DEBUG build only.
sl@0: @panic BAFL 71 aPtr is NULL. DEBUG build only.
sl@0: @leave KErrOff The new iCurrentPtr points beyond the buffer end. */
sl@0: void TResourceReaderImpl::MovePtrL(const TUint8* aPtr)
sl@0:     {
sl@0: 	__ASSERT_DEBUG(iBuffer != NULL, Panic(EBafPanicNullPtr1));
sl@0: 	__ASSERT_DEBUG(aPtr != NULL, Panic(EBafPanicNullPtr2));
sl@0: 	iAssertObj.AssertRelL(aPtr<=(iBuffer->Ptr()+iBuffer->Length()), EBafPanicResourceReaderEndExceeded);
sl@0:     iCurrentPtr=aPtr;
sl@0:     }
sl@0: 
sl@0: /** Interprets the data at the current buffer position as leading byte count data 
sl@0: and constructs an 8 bit heap descriptor containing a copy of this data.
sl@0: 
sl@0: The data is interpreted as:
sl@0: 
sl@0: a byte value defining the number of 8 bit text characters or the length of 
sl@0: binary data (the resource string/binary data length is limited to 255 characters max)
sl@0: 
sl@0: followed by:
sl@0: 
sl@0: the 8 bit text characters or binary data.
sl@0: 
sl@0: If the value of the leading byte is zero, the function assumes that no data 
sl@0: follows the leading byte and returns a NULL pointer.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: Use this explicit 8 bit variant when the resource contains binary data. If 
sl@0: the resource contains text, then use the build independent variant ReadHBufCL().
sl@0: 
sl@0: In general, this type of resource data corresponds to one of the following:
sl@0: 
sl@0: a LTEXT type in a resource STRUCT declaration.
sl@0: 
sl@0: a variable length array within a STRUCT declaration which includes the LEN 
sl@0: BYTE keywords.
sl@0: 
sl@0: @internalComponent
sl@0: @pre The same as for ReadTPtrC8L().
sl@0: @return Pointer to the 8 bit heap descriptor containing a
sl@0: copy of the data following the leading byte count at
sl@0: the current position within the resource buffer. The
sl@0: pointer can be NULL.
sl@0: @post iCurrentPtr is updated.
sl@0: @panic The same as ReadTPtrC8L().
sl@0: @leave The same as ReadTPtrC8L().
sl@0: @see ReadTPtrC8L() */
sl@0: HBufC8* TResourceReaderImpl::ReadHBufC8L()
sl@0: 	{
sl@0: 	const TPtrC8 data(ReadTPtrC8L());
sl@0: 	return (data.Length()==0)? NULL: data.AllocL();
sl@0: 	}
sl@0: 
sl@0: /** Interprets the data at the current buffer position as leading byte count data 
sl@0: and constructs a 16 bit heap descriptor containing a copy of this data.
sl@0: 
sl@0: The data is interpreted as:
sl@0: 
sl@0: a byte value defining the number of 16 bit text characters
sl@0: (the resource string/binary data length is limited to 255 characters max)
sl@0: 
sl@0: followed by:
sl@0: 
sl@0: the 16 bit text characters.
sl@0: 
sl@0: If the value of the leading byte is zero, the function assumes that no data 
sl@0: follows the leading byte and returns a NULL pointer.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: Do not use this explicit 16 bit variant when the resource contains binary 
sl@0: data; use the explicit 8 bit variant instead. If the resource contains text, 
sl@0: use the build independent variant ReadHBufCL().
sl@0: 
sl@0: @internalComponent
sl@0: @pre The same as for ReadTPtrC16L().
sl@0: @return Pointer to the 16bit heap descriptor containing a
sl@0: copy of the data following the leading byte count at
sl@0: the current position within the resource buffer. The
sl@0: pointer can be NULL.
sl@0: @post iCurrentPtr is updated.
sl@0: @panic The same as ReadTPtrC16L().
sl@0: @leave The same as ReadTPtrC16L(). 
sl@0: @see ReadTPtrC16L() */
sl@0: HBufC16* TResourceReaderImpl::ReadHBufC16L()
sl@0: 	{
sl@0: 	const TPtrC16 data(ReadTPtrC16L());
sl@0: 	return (data.Length()==0)? NULL: data.AllocL();
sl@0: 	}
sl@0: 
sl@0: /** Interprets the data at the current buffer position as leading byte count data 
sl@0: and constructs an 8 bit non modifiable pointer descriptor to represent this 
sl@0: data.
sl@0: 
sl@0: The data is interpreted as:
sl@0: 
sl@0: a byte value defining the number of text characters or the length of binary 
sl@0: data (the resource string/binary data length is limited to 255 characters max)
sl@0: 
sl@0: followed by:
sl@0: 
sl@0: the 8 bit text characters or binary data.
sl@0: 
sl@0: If the value of the leading byte is zero, calling Length() on the returned 
sl@0: TPtrC8 returns zero.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: Use this explicit 8 bit variant when the resource contains binary data. If 
sl@0: the resource contains text, then use the build independent variant ReadTPtrC().
sl@0: 
sl@0: In general, this type of resource data corresponds to one of the following:
sl@0: 
sl@0: a LTEXT type in a resource STRUCT declaration.
sl@0: 
sl@0: a variable length array within a STRUCT declaration which includes the LEN 
sl@0: BYTE keywords.
sl@0: 
sl@0: @internalComponent
sl@0: @pre iCurrentPtr != NULL.
sl@0: @pre The same as MovePtrL(const TUint8* aPtr).
sl@0: @return 8bit non modifiable pointer descriptor representing
sl@0: the data following the leading byte count at the
sl@0: current position within the resource buffer.
sl@0: @post iCurrentPtr is updated.
sl@0: @panic BAFL 72 iCurrentPtr is NULL. DEBUG build only.
sl@0: @panic The same as MovePtrL(const TUint8* aPtr).
sl@0: @leave The same as MovePtrL(const TUint8* aPtr).
sl@0: @see MovePtrL(const TUint8* aPtr) */
sl@0: TPtrC8 TResourceReaderImpl::ReadTPtrC8L()
sl@0: 	{
sl@0: 	__ASSERT_DEBUG(iCurrentPtr != NULL, Panic(EBafPanicNullPtr3));
sl@0: 	const TUint8* currentPtr=iCurrentPtr;//TUint8 pointer is used, which means that the 
sl@0: 	//resource string length is limited to 255 characters max.
sl@0: 	const TInt strLen=*currentPtr;
sl@0: 	++currentPtr;
sl@0: 	MovePtrL(currentPtr+strLen);
sl@0: 	return TPtrC8(currentPtr,strLen);
sl@0: 	}
sl@0: 
sl@0: /** Interprets the data at the current buffer position as leading byte count data 
sl@0: and constructs a 16 bit non modifiable pointer descriptor to represent this 
sl@0: data.
sl@0: 
sl@0: The data is interpreted as:
sl@0: 
sl@0: a byte value defining the number of 16 bit text characters 
sl@0: (the resource string/binary data length is limited to 255 characters max)
sl@0: 
sl@0: followed by:
sl@0: 
sl@0: the 16 bit text characters.
sl@0: 
sl@0: If the value of the leading byte is zero, calling Length() on the returned 
sl@0: TPtrC16 returns zero.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: Do not use this explicit 16 bit variant when the resource contains binary 
sl@0: data; use the explicit 8 bit variant instead. If the resource contains text, 
sl@0: use the build independent variant ReadTPtrC().
sl@0: 
sl@0: @internalComponent
sl@0: @pre iCurrentPtr != NULL.
sl@0: @pre The same as MovePtrL(const TUint8* aPtr).
sl@0: @return Pointer to an 8bit variant flat descriptor array.
sl@0: @post iCurrentPtr is updated.
sl@0: @panic BAFL 73 iCurrentPtr is NULL. DEBUG build only.
sl@0: @panic BAFL 15 The resource is a unicode string and it is not properly aligned. DEBUG build only.
sl@0: @panic The same as MovePtrL(const TUint8* aPtr).
sl@0: @leave KErrCorrupt The resource is a unicode string and it is not properly aligned.
sl@0: @leave The same as MovePtrL(const TUint8* aPtr).
sl@0: @see MovePtrL(const TUint8* aPtr) */
sl@0: TPtrC16 TResourceReaderImpl::ReadTPtrC16L()
sl@0: 	{
sl@0: 	__ASSERT_DEBUG(iCurrentPtr != NULL, Panic(EBafPanicNullPtr4));
sl@0: 	const TUint8* currentPtr=iCurrentPtr;//TUint8 pointer is used, which means that the 
sl@0: 	//resource string length is limited to 255 characters max.
sl@0: 	const TInt unicodeLength=*currentPtr;
sl@0: 	++currentPtr;
sl@0: 	if (unicodeLength!=0)
sl@0: 		{
sl@0: 		if (REINTERPRET_CAST(TUint,currentPtr)&0x1)
sl@0: 			{
sl@0: 			// The resource compiler puts out a padding byte (arbitrarily 0xab)
sl@0: 			// to ensure the alignment of Unicode strings within each resource.
sl@0: 			iAssertObj.AssertDebL(*currentPtr==0xab, EBafPanicUnicodeTextPaddingError);
sl@0: 			++currentPtr;
sl@0: 			}
sl@0: 		}
sl@0: 	const TPtrC16 unicode(REINTERPRET_CAST(const TText16*,(unicodeLength==0)? NULL: currentPtr),unicodeLength);
sl@0: 	currentPtr+=unicodeLength*sizeof(TText16);
sl@0: 	MovePtrL(currentPtr);
sl@0: 	return unicode;
sl@0: 	}
sl@0: 
sl@0: /** Interprets the data within the specified resource buffer as an array of leading 
sl@0: byte count data and constructs an 8 bit non modifiable pointer descriptor 
sl@0: to represent an element within this array.
sl@0: 
sl@0: The function sets the buffer containing the resource data and sets the current 
sl@0: position to the start of this buffer. Any buffer set by a previous call to 
sl@0: SetBuffer() etc, is lost.
sl@0: 
sl@0: The buffer is expected to contain an array of data elements preceded by a 
sl@0: TInt16 value defining the number of elements within that array.
sl@0: 
sl@0: Each element of the array is interpreted as:
sl@0: 
sl@0: a byte value defining the number of 8 bit text characters or the length of 
sl@0: binary data (the resource string/binary data length is limited to 255 characters max)
sl@0: 
sl@0: followed by:
sl@0: 
sl@0: the 8 bit text characters or binary data.
sl@0: 
sl@0: If the value of the leading byte is zero, calling Length() on the returned 
sl@0: TPtrC8 returns zero.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: Use this explicit 8 bit variant when the resource contains binary data, If 
sl@0: the resource contains text, then use the build independent variant ReadTPtrC(TInt,const TDesC8*).
sl@0: 
sl@0: @internalComponent
sl@0: @pre aBuffer != NULL. 
sl@0: @pre The same as MovePtrL(const TUint8* aPtr).
sl@0: @param aIndex Position of the element within the array. This
sl@0: value is relative to zero.
sl@0: @param aBuffer Buffer containing the resource data.
sl@0: @return 8bit non modifiable pointer descriptor representing
sl@0: the data following the leading byte count at the
sl@0: current position within the resource buffer.
sl@0: @post iBuffer is initialized with aBuffer.
sl@0: @post The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic BAFL 4 aIndex is greater or equal than the string length. DEBUG build only.
sl@0: @panic The same as MovePtrL(const TUint8* aPtr).
sl@0: @leave The same as MovePtrL(const TUint8* aPtr).
sl@0: @see MovePtrL(const TUint8* aPtr) */
sl@0: TPtrC8 TResourceReaderImpl::ReadTPtrC8L(TInt aIndex,const TDesC8* aBuffer)
sl@0:     { // implementation could be made more efficient if desired
sl@0: 	SetBuffer(aBuffer);
sl@0: 	TInt count=ReadInt16L();
sl@0: //
sl@0: 	__ASSERT_DEBUG(aIndex<count,Panic(EBafPanicResourceReaderEndExceeded));
sl@0: 	if (aIndex>=count)
sl@0: 		return TPtrC8();
sl@0: //
sl@0: 	const TUint8* ptr=iCurrentPtr;
sl@0: 	while (--aIndex>=0)
sl@0: 		ptr+=1+*ptr;
sl@0: 	MovePtrL(ptr);
sl@0: 	return ReadTPtrC8L();
sl@0:     }
sl@0: 
sl@0: /** Interprets the data within the specified resource buffer as an array of leading 
sl@0: byte count data and constructs a 16 bit non modifiable pointer descriptor 
sl@0: to represent an element within this array.
sl@0: 
sl@0: The function sets the buffer containing the resource data and sets the current 
sl@0: position to the start of this buffer. Any buffer set by a previous call to 
sl@0: SetBuffer() etc., is lost.
sl@0: 
sl@0: The buffer is expected to contain an array of data elements preceded by a 
sl@0: TInt16 value defining the number of elements within that array.
sl@0: 
sl@0: Each element of the array is interpreted as:
sl@0: 
sl@0: a byte value defining the number of 8 bit text characters or the length of 
sl@0: binary data (the resource string/binary data length is limited to 255 characters max)
sl@0: 
sl@0: followed by:
sl@0: 
sl@0: the 16 bit text characters.
sl@0: 
sl@0: If the value of the leading byte is zero, calling Length() on the returned 
sl@0: TPtrC16 returns zero.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: Do not use this explicit 16 bit variant when the resource contains binary 
sl@0: data; use the explicit 8 bit variant instead. If the resource contains text, 
sl@0: use the build independent variant ReadTPtrC(TInt,const TDesC8*).
sl@0: 
sl@0: @internalComponent
sl@0: @pre aBuffer != NULL.
sl@0: @pre The same as ReadTPtrC16L().
sl@0: @param aIndex The position of the element within the array. This
sl@0: value is relative to zero.
sl@0: @param aBuffer The buffer containing the resource data.
sl@0: @return 16bit non modifiable pointer descriptor representing
sl@0: the data following the leading byte count of the
sl@0: element at position within the array
sl@0: @post iBuffer is initialized with aBuffer.
sl@0: @post The same as ReadTPtrC16L().
sl@0: @panic BAFL 4 aIndex is greater or equal than the string length.
sl@0: @panic The same as ReadTPtrC16L().
sl@0: @leave KErrOff aIndex is grater or equal than the string length.
sl@0: @leave The same as ReadTPtrC16L(). 
sl@0: @see ReadTPtrC16L()*/
sl@0: TPtrC16 TResourceReaderImpl::ReadTPtrC16L(TInt aIndex,const TDesC8* aBuffer)
sl@0:     { // implementation could be made more efficient if desired
sl@0: 	SetBuffer(aBuffer);
sl@0: 	const TInt count=ReadInt16L();
sl@0: 	iAssertObj.AssertRelL(aIndex<count,EBafPanicResourceReaderEndExceeded);
sl@0: 	for (TInt i=0; i<aIndex; ++i)
sl@0: 		{
sl@0: 		ReadTPtrC16L();
sl@0: 		}
sl@0: 	return ReadTPtrC16L();
sl@0:     }
sl@0: 
sl@0: /** Interprets the data at the current buffer position as an array of leading byte 
sl@0: count data and constructs a flat array of 8 bit descriptors.
sl@0: 
sl@0: Each descriptor in the descriptor array corresponds to an element of the resource 
sl@0: array.
sl@0: 
sl@0: At the current buffer position, the buffer is expected to contain an array 
sl@0: of data elements preceded by a TInt16 value defining the number of elements 
sl@0: within that array.
sl@0: 
sl@0: Each element of the array is interpreted as:
sl@0: 
sl@0: a byte value defining the number of 8 bit text characters or the length of 
sl@0: binary data (the resource string/binary data length is limited to 255 characters max)
sl@0: 
sl@0: followed by:
sl@0: 
sl@0: the text characters or binary data.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: Use this explicit 8 bit variant when the resource contains binary data. If 
sl@0: the elements of the resource array contain text, use the build independent 
sl@0: variant of ReadDesCArrayL().
sl@0: 
sl@0: @internalComponent
sl@0: @pre The same as ReadTPtrC8L().
sl@0: @return Pointer to an 8bit variant flat descriptor array.
sl@0: @post The same as ReadTPtrC8L().
sl@0: @panic The same as ReadTPtrC8L().
sl@0: @leave The same as ReadTPtrC8L().
sl@0: @leave KErrNoMemory There is not enough memory
sl@0: for the resulting buffer.
sl@0: @see ReadTPtrC8L() */
sl@0: CDesC8ArrayFlat* TResourceReaderImpl::ReadDesC8ArrayL()
sl@0:     {
sl@0: 	TInt count=ReadInt16L();
sl@0: 	CDesC8ArrayFlat* array=new(ELeave) CDesC8ArrayFlat(count);
sl@0:     CleanupStack::PushL(array);
sl@0: 	while (--count>=0)
sl@0: 		array->AppendL(ReadTPtrC8L());
sl@0:     CleanupStack::Pop();
sl@0: 	return(array);
sl@0:     }
sl@0: 
sl@0: /** Interprets the data at the current buffer position as an array of leading byte 
sl@0: count data and constructs a flat array of 16 bit descriptors.
sl@0: 
sl@0: Each descriptor in the descriptor array corresponds to an element of the resource 
sl@0: array.
sl@0: 
sl@0: At the current buffer position, the buffer is expected to contain an array 
sl@0: of data elements preceded by a TInt16 value defining the number of elements 
sl@0: within that array.
sl@0: 
sl@0: Each element of the array is interpreted as:
sl@0: 
sl@0: a byte value defining the number of 8 bit text characters or the length of 
sl@0: binary data (the resource string/binary data length is limited to 255 characters max)
sl@0: 
sl@0: followed by:
sl@0: 
sl@0: the 16 bit text characters.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: Do not use this explicit 16 bit variant when the resource contains binary 
sl@0: data; use the explicit 8 bit variant instead. If the resource contains text, 
sl@0: use the build independent variant ReadDesCArrayL().
sl@0: 
sl@0: @internalComponent
sl@0: @pre The same as ReadTPtrC16L().
sl@0: @return Pointer to a 16bit variant flat descriptor array.
sl@0: @post The same as ReadTPtrC16L().
sl@0: @panic The same as ReadTPtrC16L().
sl@0: @leave The same as ReadTPtrC16L().
sl@0: @leave KErrNoMemory There is not enough memory
sl@0: for the resulting buffer. 
sl@0: @see ReadTPtrC16L() */
sl@0: CDesC16ArrayFlat* TResourceReaderImpl::ReadDesC16ArrayL()
sl@0:     {
sl@0: 	TInt count=ReadInt16L();
sl@0: 	CDesC16ArrayFlat* array=new(ELeave) CDesC16ArrayFlat(count);
sl@0:     CleanupStack::PushL(array);
sl@0: 	while (--count>=0)
sl@0: 		array->AppendL(ReadTPtrC16L());
sl@0:     CleanupStack::Pop();
sl@0: 	return(array);
sl@0:     }
sl@0: 
sl@0: /** Interprets the data at the current buffer position as a TInt8 type and returns 
sl@0: the value as a TInt.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: In general, a TInt8 corresponds to a BYTE type in a resource STRUCT declaration.
sl@0: 
sl@0: Note that in Symbian OS, a TInt is at least as big as a TInt8.
sl@0: 
sl@0: @internalComponent
sl@0: @pre iCurrentPtr != NULL.
sl@0: @pre The same as MovePtrL(const TUint8* aPtr).
sl@0: @return The TInt8 value taken from the resource buffer.
sl@0: @post The same as MovePtrL(const TUint8* aPtr).
sl@0: @leave The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic BAFL 74 iCurrentPtr is NULL. DEBUG build only.
sl@0: @see MovePtrL(const TUint8* aPtr) */
sl@0: TInt TResourceReaderImpl::ReadInt8L()
sl@0:     {
sl@0: 	__ASSERT_DEBUG(iCurrentPtr != NULL, Panic(EBafPanicNullPtr5));
sl@0:     const TUint8* currentPtr=iCurrentPtr;
sl@0:     MovePtrL(currentPtr+sizeof(TInt8));
sl@0:     return(*(TInt8*)currentPtr);
sl@0:     }
sl@0: 
sl@0: /** Interprets the data at the current buffer position as a TUint8 type and returns 
sl@0: the value as a TUint.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: In general, a TUint8 corresponds to a BYTE type in a resource STRUCT declaration.
sl@0: 
sl@0: Note that in Symbian OS, a TUint is at least as big as a TUint8.
sl@0: 
sl@0: @internalComponent
sl@0: @pre iCurrentPtr != NULL.
sl@0: @pre The same as MovePtrL(const TUint8* aPtr).
sl@0: @return The TUint8 value taken from the resource buffer.
sl@0: @post The same as MovePtrL(const TUint8* aPtr).
sl@0: @leave The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic BAFL 75 iCurrentPtr is NULL. DEBUG build only. 
sl@0: @see MovePtrL(const TUint8* aPtr) */
sl@0: TUint TResourceReaderImpl::ReadUint8L()
sl@0:     {
sl@0: 	__ASSERT_DEBUG(iCurrentPtr != NULL, Panic(EBafPanicNullPtr6));
sl@0:     const TUint8* currentPtr=iCurrentPtr;
sl@0:     MovePtrL(currentPtr+sizeof(TUint8));
sl@0:     return(*(TUint8*)currentPtr);
sl@0:     }
sl@0: 
sl@0: /** Interprets the data at the current buffer position as a TInt16 type and returns 
sl@0: the value as a TInt.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: In general, a TInt16 corresponds to a WORD type in a resource STRUCT declaration.
sl@0: 
sl@0: Note that in Symbian OS, a TInt is at least as big as a TInt16.
sl@0: 
sl@0: @internalComponent
sl@0: @pre iCurrentPtr != NULL.
sl@0: @pre The same as MovePtrL(const TUint8* aPtr).
sl@0: @return The TInt16 value taken from the resource buffer.
sl@0: @post The same as MovePtrL(const TUint8* aPtr).
sl@0: @leave The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic BAFL 76 iCurrentPtr is NULL. DEBUG build only.
sl@0: @see MovePtrL(const TUint8* aPtr) */
sl@0: TInt TResourceReaderImpl::ReadInt16L()
sl@0:     {
sl@0: 	__ASSERT_DEBUG(iCurrentPtr != NULL, Panic(EBafPanicNullPtr7));
sl@0:     if (((TUint)iCurrentPtr)%2)
sl@0:         {
sl@0:         TInt16 ret;
sl@0:         ReadL(&ret,sizeof(ret));
sl@0:         return(ret);
sl@0:         }
sl@0:     const TUint8* currentPtr=iCurrentPtr;
sl@0:     MovePtrL(currentPtr+sizeof(TInt16));
sl@0:     return(*(TInt16*)currentPtr);
sl@0:     }
sl@0: 
sl@0: /** Interprets the data at the current buffer position as a TUint16 type and returns 
sl@0: the value as a TUint.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: In general, a TUint16 corresponds to a WORD type in a resource STRUCT declaration.
sl@0: 
sl@0: Note that in Symbian OS, a TUint is at least as big as a TUint16.
sl@0: 
sl@0: @internalComponent
sl@0: @pre iCurrentPtr != NULL.
sl@0: @pre The same as MovePtrL(const TUint8* aPtr).
sl@0: @return The TUint16 value taken from the resource buffer.
sl@0: @post The same as MovePtrL(const TUint8* aPtr).
sl@0: @leave The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic BAFL 77 iCurrentPtr is NULL. DEBUG build only.
sl@0: @see MovePtrL(const TUint8* aPtr) */
sl@0: TUint TResourceReaderImpl::ReadUint16L()
sl@0:     {
sl@0: 	__ASSERT_DEBUG(iCurrentPtr != NULL, Panic(EBafPanicNullPtr8));
sl@0:     if (((TUint)iCurrentPtr)%2)
sl@0:         {
sl@0:         TUint16 ret;
sl@0:         ReadL(&ret,sizeof(ret));
sl@0:         return(ret);
sl@0:         }
sl@0:     const TUint8* currentPtr=iCurrentPtr;
sl@0:     MovePtrL(currentPtr+sizeof(TUint16));
sl@0:     return(*(TUint16*)currentPtr);
sl@0:     }
sl@0: 
sl@0: /** Interprets the data at the current buffer position as a TInt32 type and returns 
sl@0: the value as a TInt.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: In general, a TInt32 corresponds to a LONG type in a resource STRUCT declaration.
sl@0: 
sl@0: Note that in Symbian OS, TInt and TInt32 are the same size.
sl@0: 
sl@0: @internalComponent
sl@0: @pre iCurrentPtr != NULL.
sl@0: @pre The same as MovePtrL(const TUint8* aPtr).
sl@0: @return The TInt32 value taken from the resource buffer.
sl@0: @post The same as MovePtrL(const TUint8* aPtr).
sl@0: @leave The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic BAFL 78 iCurrentPtr is NULL. DEBUG build only.
sl@0: @see MovePtrL(const TUint8* aPtr) */
sl@0: TInt TResourceReaderImpl::ReadInt32L()
sl@0:     {
sl@0: 	__ASSERT_DEBUG(iCurrentPtr != NULL, Panic(EBafPanicNullPtr9));
sl@0:     if (((TUint)iCurrentPtr)%4)
sl@0:         {
sl@0:         TInt32 ret;
sl@0:         ReadL(&ret,sizeof(ret));
sl@0:         return(ret);
sl@0:         }
sl@0:     const TUint8* currentPtr=iCurrentPtr;
sl@0:     MovePtrL(currentPtr+sizeof(TInt32));
sl@0: 	return(*(TInt32*)currentPtr);
sl@0:     }
sl@0: 
sl@0: /** Interprets the data at the current buffer position as a TUint32 type and returns 
sl@0: the value as a TUint.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: In general, a TUint32 corresponds to a LONG type in a resource STRUCT declaration.
sl@0: 
sl@0: Note that in Symbian OS a TUint is the same size as a TUint32.
sl@0: 
sl@0: @internalComponent
sl@0: @pre iCurrentPtr != NULL.
sl@0: @pre The same as MovePtrL(const TUint8* aPtr).
sl@0: @return The TUint32 value taken from the resource buffer.
sl@0: @post The same as MovePtrL(const TUint8* aPtr).
sl@0: @leave The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic BAFL 79 iCurrentPtr is NULL. DEBUG build only.
sl@0: @see MovePtrL(const TUint8* aPtr) */
sl@0: TUint TResourceReaderImpl::ReadUint32L()
sl@0:     {
sl@0: 	__ASSERT_DEBUG(iCurrentPtr != NULL, Panic(EBafPanicNullPtr10));
sl@0:     if (((TUint)iCurrentPtr)%4)
sl@0:         {
sl@0:         TUint32 ret;
sl@0:         ReadL(&ret,sizeof(ret));
sl@0:         return(ret);
sl@0:         }
sl@0:     const TUint8* currentPtr=iCurrentPtr;
sl@0:     MovePtrL(currentPtr+sizeof(TUint32));
sl@0:     return(*(TUint32*)currentPtr);
sl@0:     }
sl@0: 
sl@0: /** Interprets the data at the current buffer position as a TReal64 type and returns 
sl@0: the value as a TReal64.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: In general, a TReal64 corresponds to a DOUBLE type in a resource STRUCT declaration.
sl@0: 
sl@0: @internalComponent
sl@0: @pre The same as ReadUint32L().
sl@0: @return The TReal64 value taken from the resource buffer.
sl@0: @post The same as ReadUint32L().
sl@0: @leave The same as ReadUint32L().
sl@0: @panic The same as ReadUint32L().
sl@0: @see ReadUint32L() */
sl@0: TReal64 TResourceReaderImpl::ReadReal64L() __SOFTFP
sl@0:     {
sl@0:     union
sl@0:         {
sl@0:         TReal64 ret;
sl@0:         TUint32 tmp[2];
sl@0:         };
sl@0: #if defined(__DOUBLE_WORDS_SWAPPED__)
sl@0:     tmp[1]=ReadUint32L();
sl@0:     tmp[0]=ReadUint32L();
sl@0: #else
sl@0:     tmp[0]=ReadUint32L();
sl@0:     tmp[1]=ReadUint32L();
sl@0: #endif
sl@0:     return(ret);
sl@0:     }
sl@0: 
sl@0: /** Copies a specified length of data from the resource buffer, starting at the 
sl@0: current position within the buffer, into the location pointed to by a specified 
sl@0: pointer. No assumption is made about the type of data at being read.
sl@0: 
sl@0: The current position within the resource buffer is updated.
sl@0: 
sl@0: @internalComponent
sl@0: @pre iCurrentPtr != NULL.
sl@0: @pre The same as MovePtrL(const TUint8* aPtr).
sl@0: @param aPtr Pointer to the target location for data copied from the resource buffer.
sl@0: @param  aLength The length of data to be copied from the resource buffer.
sl@0: @post The same as MovePtrL(const TUint8* aPtr).
sl@0: @leave The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic BAFL 80 iCurrentPtr is NULL. DEBUG build only.
sl@0: @see MovePtrL(const TUint8* aPtr) */
sl@0: void TResourceReaderImpl::ReadL(TAny* aPtr,TInt aLength)
sl@0:     {
sl@0: 	__ASSERT_DEBUG(iCurrentPtr != NULL, Panic(EBafPanicNullPtr11));
sl@0:     const TUint8* currentPtr=iCurrentPtr;
sl@0:     MovePtrL(currentPtr+aLength);
sl@0:     Mem::Copy(aPtr,currentPtr,aLength);
sl@0:     }
sl@0: 
sl@0: /** Moves the current buffer position backwards by the specified amount.
sl@0: 
sl@0: @internalComponent
sl@0: @pre iCurrentPtr != NULL.
sl@0: @param aLength The length by which the current position is to be moved backward.
sl@0: @post iCurrentPtr is updated.
sl@0: @leave @see MovePtrL(const TUint8* aPtr).
sl@0: @panic BAFL 5 If the resulting position lies before the start of the resource.
sl@0: @panic BAFL 81 iCurrentPtr is NULL. DEBUG build only.
sl@0: @leave KErrArgument The resulting position lies before the start of the resource. */
sl@0: void TResourceReaderImpl::RewindL(TInt aLength)
sl@0:     {
sl@0: 	__ASSERT_DEBUG(iCurrentPtr != NULL, Panic(EBafPanicNullPtr12));
sl@0: 	iAssertObj.AssertRelL(!(aLength>iCurrentPtr-iBuffer->Ptr()),EBafPanicResourceReaderStartExceeded);
sl@0:     iCurrentPtr-=aLength;
sl@0:     }
sl@0: 
sl@0: /** Moves the current buffer position forwards by the specified amount.
sl@0: 
sl@0: @internalComponent
sl@0: @pre The same as MovePtrL(const TUint8* aPtr).
sl@0: @param aLength The length by which the current position is to be advanced.
sl@0: @post The same as MovePtrL(const TUint8* aPtr).
sl@0: @leave The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic The same as MovePtrL(const TUint8* aPtr).
sl@0: @panic BAFL 82 iCurrentPtr is NULL. DEBUG build only.
sl@0: @see MovePtrL(const TUint8* aPtr) */
sl@0: void TResourceReaderImpl::AdvanceL(TInt aLength)
sl@0: 	{
sl@0: 	__ASSERT_DEBUG(iCurrentPtr != NULL, Panic(EBafPanicNullPtr13));
sl@0: 	MovePtrL(iCurrentPtr+aLength);
sl@0: 	}
sl@0: 
sl@0: /** The method sets a new iAssertObj. 
sl@0: If some method is called and something goes wrong - the method either
sl@0: will panics or asserts depending on iAssertObj state.
sl@0: 
sl@0: @internalComponent
sl@0: @param  aAssertObj The assert object.
sl@0: @post iAssertObj is updated. */
sl@0: void TResourceReaderImpl::SetAssertObj(const TBaAssert& aAssertObj)
sl@0: 	{
sl@0: 	iAssertObj = aAssertObj;
sl@0: 	}
sl@0: