1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/ossrv/lowlevellibsandfws/apputils/inc/BaRsReadImpl.h	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,99 @@
     1.4 +// Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
     1.5 +// All rights reserved.
     1.6 +// This component and the accompanying materials are made available
     1.7 +// under the terms of "Eclipse Public License v1.0"
     1.8 +// which accompanies this distribution, and is available
     1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
    1.10 +//
    1.11 +// Initial Contributors:
    1.12 +// Nokia Corporation - initial contribution.
    1.13 +//
    1.14 +// Contributors:
    1.15 +//
    1.16 +// Description:
    1.17 +//
    1.18 +
    1.19 +#ifndef __BARSREADIMPL_H__
    1.20 +#define __BARSREADIMPL_H__
    1.21 +
    1.22 +#include <e32std.h>
    1.23 +#include <badesca.h>
    1.24 +#include "BaAssert.h"
    1.25 +
    1.26 +/** Interprets resource data read from a resource file.
    1.27 +
    1.28 +To use an instance of this class, pass the buffer containing the resource 
    1.29 +data to it by calling SetBuffer().
    1.30 +
    1.31 +The buffer containing the resource data is created by RResourceFile::AllocReadLC()/CResourceFile::AllocReadLC() 
    1.32 +or RResourceFile::AllocReadL()/CResourceFile::AllocReadL() which reads the specified resource into it.
    1.33 +
    1.34 +The current position within the buffer is always maintained and any request 
    1.35 +for data is always supplied from the current position. The current position 
    1.36 +is always updated .
    1.37 +
    1.38 +Expected behaviour when assignment operator or copy constructor is called:
    1.39 +The class doesn't have assignment operator and copy constructor, so the compiler generated
    1.40 +ones will be used. The buffer used by the source class instance will be shared with the 
    1.41 +destination class instance. However source and destination instances will have their own 
    1.42 +current position pointers, both pointed initially to the same buffer position.
    1.43 +
    1.44 +Methods panic/leave behaviour: "L" methods panics/leave behaviour depends on iAssertObj
    1.45 +member which could be initialized calling SetAssertObj. If iAssertObj internal state is 
    1.46 +TBaAssert::EPanic - "L" methods will panic, otherwise they will leave if something goes wrong.
    1.47 +By default "L" methods will panic.
    1.48 +
    1.49 +@internalComponent
    1.50 +@see TResourceReaderImpl::SetBuffer()
    1.51 +@see RResourceFile::AllocReadL()
    1.52 +@see RResourceFile::AllocReadLC()
    1.53 +@see CResourceFile::AllocReadL()
    1.54 +@see CResourceFile::AllocReadLC() */
    1.55 +class TResourceReaderImpl
    1.56 +    {
    1.57 +public:
    1.58 +	TResourceReaderImpl();
    1.59 +
    1.60 +    void SetBuffer(const TDesC8* aBuffer);
    1.61 +	void ResetBuffer();
    1.62 +    const TAny* Ptr();
    1.63 +
    1.64 +    // Read counted strings into allocated buffer
    1.65 +    HBufC8*  ReadHBufC8L();
    1.66 +    HBufC16* ReadHBufC16L();
    1.67 +
    1.68 +    // Build pointer from a counted string
    1.69 +    TPtrC8  ReadTPtrC8L();
    1.70 +    TPtrC16 ReadTPtrC16L();
    1.71 +
    1.72 +    // Build pointer from a counted string in an array of counted strings,
    1.73 +    // also setting the buffer to be used.
    1.74 +    TPtrC8 ReadTPtrC8L(TInt aIndex,const TDesC8* aBuffer);
    1.75 +    TPtrC16 ReadTPtrC16L(TInt aIndex,const TDesC8* aBuffer);
    1.76 +
    1.77 +    // Build an array of strings from a resource array
    1.78 +    CDesC8ArrayFlat*  ReadDesC8ArrayL();
    1.79 +    CDesC16ArrayFlat* ReadDesC16ArrayL();
    1.80 +
    1.81 +    TInt ReadInt8L();
    1.82 +    TUint ReadUint8L();
    1.83 +    TInt ReadInt16L();
    1.84 +    TUint ReadUint16L();
    1.85 +    TInt ReadInt32L();
    1.86 +    TUint ReadUint32L();
    1.87 +    TReal64 ReadReal64L() __SOFTFP;
    1.88 +
    1.89 +    void ReadL(TAny* aPtr,TInt aLength);
    1.90 +    void RewindL(TInt aLength);
    1.91 +    void AdvanceL(TInt aLength);
    1.92 +
    1.93 +	void SetAssertObj(const TBaAssert& iAssertObj);
    1.94 +private:
    1.95 +    void MovePtrL(const TUint8* aPtr);
    1.96 +private:
    1.97 +    const TDesC8* iBuffer;
    1.98 +    const TUint8* iCurrentPtr;
    1.99 +    TBaAssert iAssertObj;
   1.100 +    };
   1.101 +
   1.102 +#endif//__BARSREADIMPL_H__