sl@0: // Copyright (c) 2006-2010 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 __SQLBUFITERATOR_H__
sl@0: #define __SQLBUFITERATOR_H__
sl@0: 
sl@0: #include <sqldb.h>			//TSqlColumnType
sl@0: #include "SqlBufFlat.h"		//RSqlBufFlat
sl@0: #include "SqlAssert.h"	
sl@0: 
sl@0: //Forward declarations
sl@0: class MStreamBuf;
sl@0: 
sl@0: /**
sl@0: ZeroBlob column type. Used internally.
sl@0: @internalComponent
sl@0: */
sl@0: enum {ESqlZeroBlob = ESqlBinary + 1};
sl@0: 
sl@0: inline TBool IsSequenceSqlType(TInt aType)
sl@0: 	{
sl@0: 	return aType == ESqlNull || aType == ESqlText || aType == ESqlBinary;
sl@0: 	}
sl@0: 
sl@0: //////////////////////////////////////////////////////////////////////////////////////
sl@0: /////////////////////  Column type conversion table  /////////////////////////////////
sl@0: //////////////////////////////////////////////////////////////////////////////////////
sl@0: //|--------------------------------------------------------------------------------|//
sl@0: //|Column type | ColumnInt() ColumnInt64() ColumnReal() ColumnText() ColumnBinary()|//
sl@0: //|--------------------------------------------------------------------------------|//
sl@0: //|Null........|.0...........0.............0.0..........KNullDesC....KNullDesC8....|//
sl@0: //|Int.........|.Int.........Int64.........Real.........KNullDesC....KNullDesC8....|//
sl@0: //|Int64.......|.clamp.......Int64.........Real.........KNullDesC....KNullDesC8....|//
sl@0: //|Real........|.round.......round.........Real.........KNullDesC....KNullDesC8....|//
sl@0: //|Text........|.0...........0.............0.0..........Text.........KNullDesC8....|//   
sl@0: //|Binary......|.0...........0.............0.0..........KNullDesC....Binary........|//
sl@0: //|--------------------------------------------------------------------------------|//
sl@0: //- "clamp": return KMinTInt or KMaxTInt if the value is outside the range that can //
sl@0: //  be represented by the type returned by the accessor function.                   //
sl@0: //- "round": the floating point value will be rounded up to the nearest integer.    //
sl@0: //  If the result is outside the range that can be represented by the type returned //
sl@0: //  by the accessor function, then it will be clamped.                              //
sl@0: //////////////////////////////////////////////////////////////////////////////////////
sl@0: 
sl@0: /**
sl@0: TSqlBufRIterator iterator gives read-only access to the flat buffer content (RSqlBufFlat class).
sl@0: For convenience TSqlBufRIterator can represent the flat buffer fields content as one of the basic
sl@0: SQL types: TInt, TInt64, TReal, 16-bit text, 8-bit binary block.
sl@0: The text and binary fields may be accessed also as a byte stream.
sl@0: 
sl@0: @see RSqlBufFlat
sl@0: 
sl@0: @internalComponent
sl@0: */
sl@0: class TSqlBufRIterator
sl@0: 	{
sl@0: public:	
sl@0: 	inline void Set(const RSqlBufFlat& aBuf);
sl@0: 	inline TBool Next();
sl@0: 	inline void MoveTo(TInt aIndex);
sl@0: 	
sl@0: 	inline TBool IsPresent() const;
sl@0: 	inline TInt Type() const;
sl@0: 	inline TInt Size() const;
sl@0: 	
sl@0: 	TInt Int() const;
sl@0: 	TInt64 Int64() const;
sl@0: 	TReal Real() const;
sl@0: 	TPtrC8 Binary() const;
sl@0: 	TPtrC16 Text() const;
sl@0: 	
sl@0: 	MStreamBuf* StreamL() const;
sl@0: 
sl@0: private:
sl@0: 	inline TInt AsInt() const;
sl@0: 	inline TInt64 AsInt64() const;
sl@0: 	inline TReal AsReal() const;
sl@0: 	
sl@0: private:
sl@0: 	const RSqlBufFlat::TCell*	iCurrent;
sl@0: 	const RSqlBufFlat::TCell*	iBegin;
sl@0: 	const RSqlBufFlat::TCell*	iEnd;
sl@0: 	
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: TSqlBufWIterator iterator gives write-only access to the flat buffer content (RSqlBufFlat class).
sl@0: For convenience, with TSqlBufWIterator flat buffer fields can be set as:
sl@0: TInt, TInt64, TReal, 16-bit text, 8-bit binary block.
sl@0: 
sl@0: @see RSqlBufFlat
sl@0: 
sl@0: @internalComponent
sl@0: */
sl@0: class TSqlBufWIterator
sl@0: 	{
sl@0: public:
sl@0: 	inline void Set(RSqlBufFlat& aBuf);
sl@0: 	inline TBool Next();
sl@0: 	inline void MoveTo(TInt aIndex);
sl@0: 	
sl@0: 	inline void SetNull();
sl@0: 	inline void SetAsNotPresent(TInt aType, TInt aLength);
sl@0: 	inline TInt SetInt(TInt aValue);
sl@0: 	inline TInt SetInt64(TInt64 aValue);
sl@0: 	inline TInt SetReal(TReal aValue);
sl@0: 	inline TInt SetBinary(const TDesC8& aValue);
sl@0: 	inline TInt SetText(const TDesC16& aValue);
sl@0: 	inline TInt SetZeroBlob(TInt aSize);
sl@0: 	
sl@0: private:
sl@0: 	RSqlBufFlat*	iBuf;
sl@0: 	TInt			iIndex;
sl@0: 	
sl@0: 	};
sl@0: 
sl@0: #include "SqlBufIterator.inl"
sl@0: 
sl@0: #endif //__SQLBUFITERATOR_H__