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: //
sl@0: 
sl@0: #ifndef __BARSREAD2_H__
sl@0: #define __BARSREAD2_H__
sl@0: 
sl@0: #include <e32std.h>
sl@0: #include <badesca.h>
sl@0: 
sl@0: //Forward declarations
sl@0: class TResourceReaderImpl;
sl@0: class CResourceFile;
sl@0: 
sl@0: /** Interprets resource data read from a resource file.
sl@0: 
sl@0: To use an instance of this class, pass the CResourceFile object containing the resource 
sl@0: data with aResourceId ID to it, by calling OpenL() or OpenLC(). Close the reader
sl@0: calling Close() after finishing with the resource.
sl@0: 
sl@0: The current position within the buffer is always maintained and any request 
sl@0: for data is always supplied from the current position. The current position 
sl@0: is always updated .
sl@0: 
sl@0: Expected behaviour when assignment operator or copy constructor is called:
sl@0: The class doesn't have assignment operator and copy constructor, so the compiler generated
sl@0: ones will be used. The buffer used by the source class instance will be shared with the 
sl@0: destination class instance. However source and destination instances will have their own 
sl@0: current position pointers, both pointed initially to the same buffer position.
sl@0: 
sl@0: @publishedAll
sl@0: @released
sl@0: @see CResourceFile */
sl@0: class RResourceReader
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C RResourceReader();
sl@0: 	IMPORT_C ~RResourceReader();
sl@0: 	IMPORT_C void OpenL(const CResourceFile* aRscFile, TInt aResourceId);
sl@0: 	IMPORT_C void OpenLC(const CResourceFile* aRscFile, TInt aResourceId);
sl@0: 	IMPORT_C void OpenL(const TDesC8& aRscData);
sl@0: 	IMPORT_C void OpenLC(const TDesC8& aRscData);
sl@0: 	IMPORT_C void Close();
sl@0: 
sl@0:     // Read counted strings into allocated buffer
sl@0:     IMPORT_C HBufC*   ReadHBufCL();
sl@0:     IMPORT_C HBufC8*  ReadHBufC8L();
sl@0:     IMPORT_C HBufC16* ReadHBufC16L();
sl@0: 
sl@0:     // Build pointer from a counted string
sl@0:     IMPORT_C TPtrC   ReadTPtrCL();
sl@0:     IMPORT_C TPtrC8  ReadTPtrC8L();
sl@0:     IMPORT_C TPtrC16 ReadTPtrC16L();
sl@0: 
sl@0:     // Build an array of strings from a resource array
sl@0:     IMPORT_C CDesCArrayFlat*   ReadDesCArrayL();
sl@0:     IMPORT_C CDesC8ArrayFlat*  ReadDesC8ArrayL();
sl@0:     IMPORT_C CDesC16ArrayFlat* ReadDesC16ArrayL();
sl@0: 
sl@0:     IMPORT_C TInt ReadInt8L();
sl@0:     IMPORT_C TUint ReadUint8L();
sl@0:     IMPORT_C TInt ReadInt16L();
sl@0:     IMPORT_C TUint ReadUint16L();
sl@0:     IMPORT_C TInt ReadInt32L();
sl@0:     IMPORT_C TUint ReadUint32L();
sl@0:     IMPORT_C TReal64 ReadReal64L() __SOFTFP;
sl@0: 
sl@0:     IMPORT_C void ReadL(TAny* aPtr,TInt aLength);
sl@0:     IMPORT_C void RewindL(TInt aLength);
sl@0:     IMPORT_C void AdvanceL(TInt aLength);
sl@0: private:
sl@0: 	TResourceReaderImpl* Impl();
sl@0: 	const TResourceReaderImpl* Impl() const;
sl@0: private:
sl@0: 	//Size of the RResourceReader implementation.
sl@0: 	//It should be 12 because of the BC reasons.
sl@0: 	//That's the size of the implementation class,
sl@0: 	//which implements TResourceReader functionality too.
sl@0: 	enum
sl@0: 		{
sl@0: 		KRsReaderSize = 12
sl@0: 		};
sl@0: 	TUint8 iImpl[KRsReaderSize];
sl@0: 	HBufC8* iRscBuffer;
sl@0: 	};
sl@0: 
sl@0: #endif//__BARSREAD2_H__