sl@0: // Copyright (c) 2006-2009 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: // //               RSqlBufFlat class          //
sl@0: // 
sl@0: //
sl@0: 
sl@0: /**
sl@0:  
sl@0:  @return Flat buffer elements count
sl@0: */
sl@0: inline TInt RSqlBufFlat::Count() const
sl@0: 	{
sl@0: 	SQLFLATBUF_INVARIANT();
sl@0: 	return iBuf->iCount;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @return Flat buffer size (this is not the max size. It refers only to the used part of the flat buffer)
sl@0: */
sl@0: inline TInt RSqlBufFlat::Size() const
sl@0: 	{
sl@0: 	SQLFLATBUF_INVARIANT();
sl@0: 	return iBuf->iSize;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @return Flat buffer max size
sl@0: */
sl@0: inline TInt RSqlBufFlat::MaxSize() const
sl@0: 	{
sl@0: 	SQLFLATBUF_INVARIANT();
sl@0: 	return iMaxSize;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @return A pointer to the beginning of the flat buffer header
sl@0: */
sl@0: inline RSqlBufFlat::TCell* RSqlBufFlat::Header()
sl@0: 	{
sl@0: 	return reinterpret_cast <RSqlBufFlat::TCell*> (iBuf + 1);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @return A const pointer to the beginning of the flat buffer header
sl@0: */
sl@0: inline const RSqlBufFlat::TCell* RSqlBufFlat::Header() const 
sl@0: 	{
sl@0: 	return reinterpret_cast <const RSqlBufFlat::TCell*> (iBuf + 1);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @return The avaliable space in the flat buffer
sl@0: */
sl@0: inline TInt RSqlBufFlat::Available() const
sl@0: 	{
sl@0: 	return iMaxSize - iBuf->iSize;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: This function returns a const reference to a descriptor object pointing to the internal buffer.
sl@0: BufDes() guarantees to return a const descriptor, whose lifetime is the same as the flat buffer lifetime.
sl@0: (useful when making asynchronous IPC calls)
sl@0: 
sl@0: @return A reference to a descriptor object pointing to the internal buffer.
sl@0: */
sl@0: inline const TDesC8& RSqlBufFlat::BufDes() const
sl@0: 	{
sl@0: 	SQLFLATBUF_INVARIANT();
sl@0: 	iBufPtrC.Set(reinterpret_cast <const TUint8*> (iBuf), iBuf->iSize);
sl@0: 	return iBufPtrC;	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: This function returns a modifiable reference to a descriptor object pointing to the internal buffer.
sl@0: BufPtr() guarantees to return a modifiable descriptor, whose lifetime is the same as the flat buffer lifetime.
sl@0: (useful when making asynchronous IPC calls)
sl@0: 
sl@0: @return A reference to a modifiable descriptor object pointing to the internal buffer.
sl@0: */
sl@0: inline TPtr8& RSqlBufFlat::BufPtr()
sl@0: 	{
sl@0: 	SQLFLATBUF_INVARIANT();
sl@0: 	iBufPtr.Set(reinterpret_cast <TUint8*> (iBuf), iBuf->iSize, iMaxSize);
sl@0: 	return iBufPtr;	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @return The minimal allowed buffer size: sizeof(TBufFlat) + size of the header
sl@0: */
sl@0: inline TInt RSqlBufFlat::SysDataSize() const
sl@0: 	{
sl@0: 	return iBuf->iHeaderSize + sizeof(RSqlBufFlat::TBufFlat);
sl@0: 	}