// 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:
//

#ifndef __SQLBUFITERATOR_H__
#define __SQLBUFITERATOR_H__

#include <sqldb.h>			//TSqlColumnType
#include "SqlBufFlat.h"		//RSqlBufFlat
#include "SqlPanic.h"	

//Forward declarations
class MStreamBuf;

/**
ZeroBlob column type. Used internally.
@internalComponent
*/
enum {ESqlZeroBlob = ESqlBinary + 1};

inline TBool IsSequenceSqlType(TInt aType)
	{
	return aType == ESqlNull || aType == ESqlText || aType == ESqlBinary;
	}

//////////////////////////////////////////////////////////////////////////////////////
/////////////////////  Column type conversion table  /////////////////////////////////
//////////////////////////////////////////////////////////////////////////////////////
//|--------------------------------------------------------------------------------|//
//|Column type | ColumnInt() ColumnInt64() ColumnReal() ColumnText() ColumnBinary()|//
//|--------------------------------------------------------------------------------|//
//|Null........|.0...........0.............0.0..........KNullDesC....KNullDesC8....|//
//|Int.........|.Int.........Int64.........Real.........KNullDesC....KNullDesC8....|//
//|Int64.......|.clamp.......Int64.........Real.........KNullDesC....KNullDesC8....|//
//|Real........|.round.......round.........Real.........KNullDesC....KNullDesC8....|//
//|Text........|.0...........0.............0.0..........Text.........KNullDesC8....|//   
//|Binary......|.0...........0.............0.0..........KNullDesC....Binary........|//
//|--------------------------------------------------------------------------------|//
//- "clamp": return KMinTInt or KMaxTInt if the value is outside the range that can //
//  be represented by the type returned by the accessor function.                   //
//- "round": the floating point value will be rounded up to the nearest integer.    //
//  If the result is outside the range that can be represented by the type returned //
//  by the accessor function, then it will be clamped.                              //
//////////////////////////////////////////////////////////////////////////////////////

/**
TSqlBufRIterator iterator gives read-only access to the flat buffer content (RSqlBufFlat class).
For convenience TSqlBufRIterator can represent the flat buffer fields content as one of the basic
SQL types: TInt, TInt64, TReal, 16-bit text, 8-bit binary block.
The text and binary fields may be accessed also as a byte stream.

@see RSqlBufFlat

@internalComponent
*/
class TSqlBufRIterator
	{
public:	
	inline void Set(const RSqlBufFlat& aBuf);
	inline TBool Next();
	inline void MoveTo(TInt aIndex);
	
	inline TBool IsPresent() const;
	inline TInt Type() const;
	inline TInt Size() const;
	
	TInt Int() const;
	TInt64 Int64() const;
	TReal Real() const;
	TPtrC8 Binary() const;
	TPtrC16 Text() const;
	
	MStreamBuf* StreamL() const;

private:
	inline TInt AsInt() const;
	inline TInt64 AsInt64() const;
	inline TReal AsReal() const;
	
private:
	const RSqlBufFlat::TCell*	iCurrent;
	const RSqlBufFlat::TCell*	iBegin;
	const RSqlBufFlat::TCell*	iEnd;
	
	};

/**
TSqlBufWIterator iterator gives write-only access to the flat buffer content (RSqlBufFlat class).
For convenience, with TSqlBufWIterator flat buffer fields can be set as:
TInt, TInt64, TReal, 16-bit text, 8-bit binary block.

@see RSqlBufFlat

@internalComponent
*/
class TSqlBufWIterator
	{
public:
	inline void Set(RSqlBufFlat& aBuf);
	inline TBool Next();
	inline void MoveTo(TInt aIndex);
	
	inline void SetNull();
	inline void SetAsNotPresent(TInt aType, TInt aLength);
	inline TInt SetInt(TInt aValue);
	inline TInt SetInt64(TInt64 aValue);
	inline TInt SetReal(TReal aValue);
	inline TInt SetBinary(const TDesC8& aValue);
	inline TInt SetText(const TDesC16& aValue);
	inline TInt SetZeroBlob(TInt aSize);
	
private:
	RSqlBufFlat*	iBuf;
	TInt			iIndex;
	
	};

#include "SqlBufIterator.inl"

#endif //__SQLBUFITERATOR_H__