--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/lowlevellibsandfws/apputils/inc/BaRsReadImpl.h Tue Feb 02 02:01:42 2010 +0200
@@ -0,0 +1,99 @@
+// Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+#ifndef __BARSREADIMPL_H__
+#define __BARSREADIMPL_H__
+
+#include <e32std.h>
+#include <badesca.h>
+#include "BaAssert.h"
+
+/** Interprets resource data read from a resource file.
+
+To use an instance of this class, pass the buffer containing the resource
+data to it by calling SetBuffer().
+
+The buffer containing the resource data is created by RResourceFile::AllocReadLC()/CResourceFile::AllocReadLC()
+or RResourceFile::AllocReadL()/CResourceFile::AllocReadL() which reads the specified resource into it.
+
+The current position within the buffer is always maintained and any request
+for data is always supplied from the current position. The current position
+is always updated .
+
+Expected behaviour when assignment operator or copy constructor is called:
+The class doesn't have assignment operator and copy constructor, so the compiler generated
+ones will be used. The buffer used by the source class instance will be shared with the
+destination class instance. However source and destination instances will have their own
+current position pointers, both pointed initially to the same buffer position.
+
+Methods panic/leave behaviour: "L" methods panics/leave behaviour depends on iAssertObj
+member which could be initialized calling SetAssertObj. If iAssertObj internal state is
+TBaAssert::EPanic - "L" methods will panic, otherwise they will leave if something goes wrong.
+By default "L" methods will panic.
+
+@internalComponent
+@see TResourceReaderImpl::SetBuffer()
+@see RResourceFile::AllocReadL()
+@see RResourceFile::AllocReadLC()
+@see CResourceFile::AllocReadL()
+@see CResourceFile::AllocReadLC() */
+class TResourceReaderImpl
+ {
+public:
+ TResourceReaderImpl();
+
+ void SetBuffer(const TDesC8* aBuffer);
+ void ResetBuffer();
+ const TAny* Ptr();
+
+ // Read counted strings into allocated buffer
+ HBufC8* ReadHBufC8L();
+ HBufC16* ReadHBufC16L();
+
+ // Build pointer from a counted string
+ TPtrC8 ReadTPtrC8L();
+ TPtrC16 ReadTPtrC16L();
+
+ // Build pointer from a counted string in an array of counted strings,
+ // also setting the buffer to be used.
+ TPtrC8 ReadTPtrC8L(TInt aIndex,const TDesC8* aBuffer);
+ TPtrC16 ReadTPtrC16L(TInt aIndex,const TDesC8* aBuffer);
+
+ // Build an array of strings from a resource array
+ CDesC8ArrayFlat* ReadDesC8ArrayL();
+ CDesC16ArrayFlat* ReadDesC16ArrayL();
+
+ TInt ReadInt8L();
+ TUint ReadUint8L();
+ TInt ReadInt16L();
+ TUint ReadUint16L();
+ TInt ReadInt32L();
+ TUint ReadUint32L();
+ TReal64 ReadReal64L() __SOFTFP;
+
+ void ReadL(TAny* aPtr,TInt aLength);
+ void RewindL(TInt aLength);
+ void AdvanceL(TInt aLength);
+
+ void SetAssertObj(const TBaAssert& iAssertObj);
+private:
+ void MovePtrL(const TUint8* aPtr);
+private:
+ const TDesC8* iBuffer;
+ const TUint8* iCurrentPtr;
+ TBaAssert iAssertObj;
+ };
+
+#endif//__BARSREADIMPL_H__