sl@0: // Copyright (c) 1997-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 <barsread.h>
sl@0: #include "BaRsReadImpl.h"
sl@0: 
sl@0: #define UNUSED_VAR(a) a = a
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: @param aBuffer A pointer to an 8-bit non-modifiable descriptor containing 
sl@0: or representing resource data. */
sl@0: EXPORT_C void TResourceReader::SetBuffer(const TDesC8* aBuffer)
sl@0: 	{
sl@0: 	CreateImpl();
sl@0: 	Impl()->SetBuffer(aBuffer);
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: @return A pointer to the current position within the resource buffer. */
sl@0: EXPORT_C const TAny* TResourceReader::Ptr()
sl@0:     {
sl@0: 	return Impl()->Ptr();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return A pointer to the 8-bit heap descriptor containing a copy of the data 
sl@0: following the leading byte count at the current position within the resource 
sl@0: buffer. The pointer can be NULL. */
sl@0: EXPORT_C HBufC8* TResourceReader::ReadHBufC8L()
sl@0: 	{
sl@0: 	return Impl()->ReadHBufC8L();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return A pointer to the 16-bit heap descriptor containing a copy of the 
sl@0: data following the leading byte count at the current position within the resource 
sl@0: buffer. The pointer can be NULL. */
sl@0: EXPORT_C HBufC16* TResourceReader::ReadHBufC16L()
sl@0: 	{
sl@0: 	return Impl()->ReadHBufC16L();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return An 8-bit non modifiable pointer descriptor representing the data 
sl@0: following the leading byte count at the current position within the resource 
sl@0: buffer. */
sl@0: EXPORT_C TPtrC8 TResourceReader::ReadTPtrC8()
sl@0: 	{
sl@0: 	TPtrC8 retPtr;
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, retPtr.Set(ReadTPtrC8L ()));
sl@0:     UNUSED_VAR(errCode);
sl@0: 	return retPtr;
sl@0: 	}
sl@0: 
sl@0: TPtrC8 TResourceReader::ReadTPtrC8L()
sl@0: 	{
sl@0: 	return Impl()->ReadTPtrC8L();
sl@0: 	}
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return A 16-bit non modifiable pointer descriptor representing the data 
sl@0: following the leading byte count at the current position within the resource 
sl@0: buffer. */
sl@0: EXPORT_C TPtrC16 TResourceReader::ReadTPtrC16()
sl@0: 	{
sl@0: 	TPtrC16 retPtr;
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, retPtr.Set(ReadTPtrC16L ()));
sl@0:     UNUSED_VAR(errCode);
sl@0: 	return retPtr;
sl@0: 	}
sl@0: 
sl@0: TPtrC16 TResourceReader::ReadTPtrC16L()
sl@0: 	{
sl@0: 	return Impl()->ReadTPtrC16L();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @param aIndex The position of the element within the array. This value is 
sl@0: relative to zero.
sl@0: @param aBuffer The buffer containing the resource data.
sl@0: @return An 8-bit non modifiable pointer descriptor representing the data following 
sl@0: the leading byte count of the element at the specified position within the 
sl@0: array. */
sl@0: EXPORT_C TPtrC8 TResourceReader::ReadTPtrC8(TInt aIndex,const TDesC8* aBuffer)
sl@0:     {
sl@0: 	TPtrC8 retPtr;
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, retPtr.Set(ReadTPtrC8L(aIndex, aBuffer)));
sl@0:     UNUSED_VAR(errCode);
sl@0: 	return retPtr;
sl@0:     }
sl@0: 
sl@0: TPtrC8 TResourceReader::ReadTPtrC8L(TInt aIndex,const TDesC8* aBuffer)
sl@0:     {
sl@0: 	CreateImpl();
sl@0: 	return Impl()->ReadTPtrC8L(aIndex,aBuffer);
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @param aIndex The position of the element within the array. This value is 
sl@0: relative to zero.
sl@0: @param aBuffer The buffer containing the resource data.
sl@0: @return A 16-bit non modifiable pointer descriptor representing the data following 
sl@0: the leading byte count of the element at position within the array */
sl@0: EXPORT_C TPtrC16 TResourceReader::ReadTPtrC16(TInt aIndex,const TDesC8* aBuffer)
sl@0:     {
sl@0: 	TPtrC16 retPtr;
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, retPtr.Set(ReadTPtrC16L(aIndex, aBuffer)));
sl@0:     UNUSED_VAR(errCode);
sl@0: 	return retPtr;
sl@0:     }
sl@0: 
sl@0: TPtrC16 TResourceReader::ReadTPtrC16L(TInt aIndex,const TDesC8* aBuffer)
sl@0:     {
sl@0: 	CreateImpl();
sl@0: 	return Impl()->ReadTPtrC16L(aIndex,aBuffer);
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return A pointer to an 8-bit variant flat descriptor array. */
sl@0: EXPORT_C CDesC8ArrayFlat* TResourceReader::ReadDesC8ArrayL()
sl@0:     {
sl@0: 	return Impl()->ReadDesC8ArrayL();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return A pointer to a 16-bit variant flat descriptor array. */
sl@0: EXPORT_C CDesC16ArrayFlat* TResourceReader::ReadDesC16ArrayL()
sl@0:     {
sl@0: 	return Impl()->ReadDesC16ArrayL();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return The TInt8 value taken from the resource buffer. */
sl@0: EXPORT_C TInt TResourceReader::ReadInt8()
sl@0:     {
sl@0: 	TInt retInt=0;
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, retInt=ReadInt8L());
sl@0:     UNUSED_VAR(errCode);
sl@0: 	return retInt;
sl@0:     }
sl@0: 
sl@0: TInt TResourceReader::ReadInt8L()
sl@0:     {
sl@0: 	return Impl()->ReadInt8L();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return The TUint8 value taken from the resource buffer. */
sl@0: EXPORT_C TUint TResourceReader::ReadUint8()
sl@0:     {
sl@0: 	TUint retInt=0;
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, retInt=ReadUint8L());
sl@0:     UNUSED_VAR(errCode);
sl@0: 	return retInt;
sl@0:     }
sl@0: 
sl@0: TUint TResourceReader::ReadUint8L()
sl@0:     {
sl@0: 	return Impl()->ReadUint8L();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return The TInt16 value taken from the resource buffer. */
sl@0: EXPORT_C TInt TResourceReader::ReadInt16()
sl@0:     {
sl@0: 	TInt retInt=0;
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, retInt=ReadInt16L());
sl@0:     UNUSED_VAR(errCode);
sl@0: 	return retInt;
sl@0:     }
sl@0: 
sl@0: TInt TResourceReader::ReadInt16L()
sl@0:     {
sl@0: 	return Impl()->ReadInt16L();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return The TUint16 value taken from the resource buffer. */
sl@0: EXPORT_C TUint TResourceReader::ReadUint16()
sl@0:     {
sl@0: 	TUint retInt=0;
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, retInt=ReadUint16L());
sl@0:     UNUSED_VAR(errCode);
sl@0: 	return retInt;
sl@0:     }
sl@0: 
sl@0: TUint TResourceReader::ReadUint16L()
sl@0:     {
sl@0: 	return Impl()->ReadUint16L();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return The TInt32 value taken from the resource buffer. */
sl@0: EXPORT_C TInt TResourceReader::ReadInt32()
sl@0:     {
sl@0: 	TInt retInt=0;
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, retInt=ReadInt32L());
sl@0:     UNUSED_VAR(errCode);
sl@0: 	return retInt;
sl@0:     }
sl@0: 
sl@0: TInt TResourceReader::ReadInt32L()
sl@0:     {
sl@0: 	return Impl()->ReadInt32L();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
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: @return The TUint32 value taken from the resource buffer. */
sl@0: EXPORT_C TUint TResourceReader::ReadUint32()
sl@0:     {
sl@0: 	TUint retInt=0;
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, retInt=ReadUint32L());
sl@0:     UNUSED_VAR(errCode);
sl@0: 	return retInt;
sl@0:     }
sl@0: 
sl@0: TUint TResourceReader::ReadUint32L()
sl@0:     {
sl@0: 	return Impl()->ReadUint32L();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
sl@0: 
sl@0: In general, a TReal64 corresponds to a DOUBLE type in a resource STRUCT declaration.
sl@0: 
sl@0: @return The TReal64 value taken from the resource buffer. */
sl@0: EXPORT_C TReal64 TResourceReader::ReadReal64() __SOFTFP
sl@0:     {
sl@0: 	TReal64 retReal=0;
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, retReal=ReadReal64L());
sl@0:     UNUSED_VAR(errCode);
sl@0: 	return retReal;
sl@0:     }
sl@0: 
sl@0: TReal64 TResourceReader::ReadReal64L() __SOFTFP
sl@0:     {
sl@0: 	return Impl()->ReadReal64L();
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. If the resulting 
sl@0: position lies beyond the end of the resource buffer, then the function raises 
sl@0: a BAFL 4 panic.
sl@0: 
sl@0: @param aPtr A pointer to the target location for data copied from the resource 
sl@0: buffer.
sl@0: @param aLength The length of data to be copied from the resource buffer. */
sl@0: EXPORT_C void TResourceReader::Read(TAny* aPtr,TInt aLength)
sl@0:     {
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, Impl()->ReadL(aPtr,aLength));
sl@0:     UNUSED_VAR(errCode);
sl@0:     }
sl@0: 
sl@0: /** Moves the current buffer position backwards by the specified amount.
sl@0: 
sl@0: If the resulting position lies before the start of the resource buffer, then 
sl@0: the function raises a BAFL 5 panic.
sl@0: 
sl@0: @param aLength The length by which the current position is to be moved backward. */
sl@0: EXPORT_C void TResourceReader::Rewind(TInt aLength)
sl@0:     {
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, Impl()->RewindL(aLength));
sl@0:     UNUSED_VAR(errCode);
sl@0:     }
sl@0: 
sl@0: /** Moves the current buffer position forwards by the specified amount.
sl@0: 
sl@0: If the resulting position lies beyond the end of the resource buffer, then 
sl@0: the function raises a BAFL 4 panic.
sl@0: 
sl@0: @param aLength The length by which the current position is to be advanced. */
sl@0: EXPORT_C void TResourceReader::Advance(TInt aLength)
sl@0: 	{
sl@0: 	// TRAP and ignore the Error code as its non leaving method
sl@0: 	TRAPD(errCode, Impl()->AdvanceL(aLength));
sl@0:     UNUSED_VAR(errCode);
sl@0: 	}
sl@0: 
sl@0: /** Placement new operator is used TResourceReaderImpl instance to be created.
sl@0: TResourceReaderImpl instance default behaviour - it will panic when there is a problem.
sl@0: 
sl@0: @internalComponent */
sl@0: void TResourceReader::CreateImpl()
sl@0: 	{
sl@0: 	new (iImpl) TResourceReaderImpl;
sl@0: 	}
sl@0: 
sl@0: /** Placement new operator is used TResourceReaderImpl instance to be created.
sl@0: TResourceReaderImpl instance default behaviour - it will panic when there is a problem.
sl@0: 
sl@0: @internalComponent */
sl@0: TResourceReaderImpl* TResourceReader::Impl()
sl@0: 	{
sl@0: 	return reinterpret_cast <TResourceReaderImpl*> (iImpl);
sl@0: 	}
sl@0: 
sl@0: /** The method returns a const pointer to TResourceReader implementation.
sl@0: 
sl@0: @internalComponent */
sl@0: const TResourceReaderImpl* TResourceReader::Impl() const
sl@0: 	{
sl@0: 	return reinterpret_cast <const TResourceReaderImpl*> (iImpl);
sl@0: 	}
sl@0: