diff -r e1b950c65cb4 -r 837f303aceeb epoc32/include/pcstore/descriptors.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/epoc32/include/pcstore/descriptors.h Wed Mar 31 12:33:34 2010 +0100 @@ -0,0 +1,122 @@ +// Copyright (c) 2006-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: +// + +#if !defined(__DESCRIPTORS_H__) +#define __DESCRIPTORS_H__ + +#include + +namespace PCStore +{ +class CMemoryBlock; +/** +@internalAll + +Class to represent 8-bit descriptors. + +This class implements a subset of 8-bit descriptor's behaviour, which are necessary +for the externalization and internalization of 8-bit descriptors. It encapsulates +the data members containing the data, its maximum length and actual length. It also +provides member functions to append and reset the data, as well as get the pointer of +the data. However, there is no method to partly modify the data. + +The constructors, Set, Append, and assignment methods take a copy of the data they're +given, which means it allocates memory to hold the data and releases it when needed. +Data represented by this class is treated as a contiguous set of 8-bit +(i.e. single byte) values or data items. +*/ +class CDes8 + { +public: + CDes8(); + CDes8(const CDes8& aDes); + explicit CDes8(TInt32 aMaxLength); + CDes8(const TUint8* aPtr); + CDes8(const TUint8* aPtr, TInt32 aLength); + CDes8(const TUint8* aPtr, TInt32 aLength, TInt32 aMaxLength); + ~CDes8(); + + const TUint8* Ptr() const; + TInt32 Length() const; + TInt32 MaxLength() const ; + TInt32 Size() const; + + void SetLength(TInt32 aLength); + void Set(const CDes8& aDes); + void Set(const TUint8* aPtr, TInt32 aLength); + void Set(const TUint8* aPtr, TInt32 aLength, TInt32 aMaxLength); + void Append(const CDes8& aDes); + void Append(const TUint8* aPtr, TInt32 aLength); + + CDes8& operator=(const CDes8& aDes); + TBool operator==(const CDes8& aDes) const; + TBool operator!=(const CDes8& aDes) const; + + +private: + CMemoryBlock* iMemoryBlock; + TInt32 iLength; + }; + + +/** +@internalAll + +Class to represent 16-bit descriptor. + +This class implements a subset of 16-bit descriptor's behaviour, which are necessary +for the externalization and internalization of 16-bit descriptors. It encapsulates +the data members containing the data, its maximum length and actual length. It also +provides member functions to access and reset, but not modify, the data. + +The constructors, Set, Append, and assignment methods take a copy of the data they're +given, which means it allocates memory to hold the data and releases it when needed. +Data represented by this class is treated as a contiguous set of 16-bit +(i.e. 2-byte word) values or data items. +*/ +class CDes16 + { + +public: + CDes16(); + CDes16(const CDes16& aDes); + explicit CDes16(TInt32 aMaxLength); + CDes16(const TUint16* aPtr); + CDes16(const TUint16* aPtr, TInt32 aLength); + CDes16(const TUint16* aPtr, TInt32 aLength, TInt32 aMaxLength); + ~CDes16(); + + const TUint16* Ptr() const; + TInt32 Length() const; + TInt32 MaxLength() const ; + TInt32 Size() const; + + void SetLength(TInt32 aLength); + void Set(const CDes16& aDes); + void Set(const TUint16* aPtr, TInt32 aLength); + void Set(const TUint16* aPtr, TInt32 aLength, TInt32 aMaxLength); + void Append(const CDes16& aDes); + void Append(const TUint16* aPtr, TInt32 aLength); + + CDes16& operator=(const CDes16& aDes); + TBool operator==(const CDes16& aDes) const; + TBool operator!=(const CDes16& aDes) const; + +private: + CMemoryBlock* iMemoryBlock; + TInt32 iLength; + }; +} +#endif // !defined(__DESCRIPTORS_H__)