1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/ossrv/lowlevellibsandfws/apputils/inc/BaRsRead2.H	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,98 @@
     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 __BARSREAD2_H__
    1.20 +#define __BARSREAD2_H__
    1.21 +
    1.22 +#include <e32std.h>
    1.23 +#include <badesca.h>
    1.24 +
    1.25 +//Forward declarations
    1.26 +class TResourceReaderImpl;
    1.27 +class CResourceFile;
    1.28 +
    1.29 +/** Interprets resource data read from a resource file.
    1.30 +
    1.31 +To use an instance of this class, pass the CResourceFile object containing the resource 
    1.32 +data with aResourceId ID to it, by calling OpenL() or OpenLC(). Close the reader
    1.33 +calling Close() after finishing with the resource.
    1.34 +
    1.35 +The current position within the buffer is always maintained and any request 
    1.36 +for data is always supplied from the current position. The current position 
    1.37 +is always updated .
    1.38 +
    1.39 +Expected behaviour when assignment operator or copy constructor is called:
    1.40 +The class doesn't have assignment operator and copy constructor, so the compiler generated
    1.41 +ones will be used. The buffer used by the source class instance will be shared with the 
    1.42 +destination class instance. However source and destination instances will have their own 
    1.43 +current position pointers, both pointed initially to the same buffer position.
    1.44 +
    1.45 +@publishedAll
    1.46 +@released
    1.47 +@see CResourceFile */
    1.48 +class RResourceReader
    1.49 +	{
    1.50 +public:
    1.51 +	IMPORT_C RResourceReader();
    1.52 +	IMPORT_C ~RResourceReader();
    1.53 +	IMPORT_C void OpenL(const CResourceFile* aRscFile, TInt aResourceId);
    1.54 +	IMPORT_C void OpenLC(const CResourceFile* aRscFile, TInt aResourceId);
    1.55 +	IMPORT_C void OpenL(const TDesC8& aRscData);
    1.56 +	IMPORT_C void OpenLC(const TDesC8& aRscData);
    1.57 +	IMPORT_C void Close();
    1.58 +
    1.59 +    // Read counted strings into allocated buffer
    1.60 +    IMPORT_C HBufC*   ReadHBufCL();
    1.61 +    IMPORT_C HBufC8*  ReadHBufC8L();
    1.62 +    IMPORT_C HBufC16* ReadHBufC16L();
    1.63 +
    1.64 +    // Build pointer from a counted string
    1.65 +    IMPORT_C TPtrC   ReadTPtrCL();
    1.66 +    IMPORT_C TPtrC8  ReadTPtrC8L();
    1.67 +    IMPORT_C TPtrC16 ReadTPtrC16L();
    1.68 +
    1.69 +    // Build an array of strings from a resource array
    1.70 +    IMPORT_C CDesCArrayFlat*   ReadDesCArrayL();
    1.71 +    IMPORT_C CDesC8ArrayFlat*  ReadDesC8ArrayL();
    1.72 +    IMPORT_C CDesC16ArrayFlat* ReadDesC16ArrayL();
    1.73 +
    1.74 +    IMPORT_C TInt ReadInt8L();
    1.75 +    IMPORT_C TUint ReadUint8L();
    1.76 +    IMPORT_C TInt ReadInt16L();
    1.77 +    IMPORT_C TUint ReadUint16L();
    1.78 +    IMPORT_C TInt ReadInt32L();
    1.79 +    IMPORT_C TUint ReadUint32L();
    1.80 +    IMPORT_C TReal64 ReadReal64L() __SOFTFP;
    1.81 +
    1.82 +    IMPORT_C void ReadL(TAny* aPtr,TInt aLength);
    1.83 +    IMPORT_C void RewindL(TInt aLength);
    1.84 +    IMPORT_C void AdvanceL(TInt aLength);
    1.85 +private:
    1.86 +	TResourceReaderImpl* Impl();
    1.87 +	const TResourceReaderImpl* Impl() const;
    1.88 +private:
    1.89 +	//Size of the RResourceReader implementation.
    1.90 +	//It should be 12 because of the BC reasons.
    1.91 +	//That's the size of the implementation class,
    1.92 +	//which implements TResourceReader functionality too.
    1.93 +	enum
    1.94 +		{
    1.95 +		KRsReaderSize = 12
    1.96 +		};
    1.97 +	TUint8 iImpl[KRsReaderSize];
    1.98 +	HBufC8* iRscBuffer;
    1.99 +	};
   1.100 +
   1.101 +#endif//__BARSREAD2_H__