commsfwutils/commsbufs/src/commsbuf.cpp
changeset 0 dfb7c4ff071f
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/commsfwutils/commsbufs/src/commsbuf.cpp	Thu Dec 17 09:22:25 2009 +0200
@@ -0,0 +1,101 @@
+// Copyright (c) 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:
+//
+
+#include "es_commsbuf_internal.h"
+#include "commsbufpondintf.h"
+#include "commsbufpool.h"
+	
+EXPORT_C RCommsBuf* RCommsBuf::Alloc(TUint aSize, TCommsBufAllocator& aAllocator)
+/**
+Allocates memory for a RCommsBuf object. 
+
+@param aSize Requested total size
+@param aAllocator A handle to the allocator
+
+@return RCommsBuf	A pointer to the allocated RCommsBuf object if allocation is success
+					or NULL if allocation is failed
+*/
+	{
+	return aAllocator.iPond.Alloc(aSize, aSize, KMaxTInt);	
+	}
+
+EXPORT_C void RCommsBuf::Append(const TDesC8& aSrc)
+/**
+Append data onto the end of RCommsBuf data. The length of the
+CommsBuf data is incremented to reflect the new content
+
+@param aSrc Data to append
+*/
+	{
+	__ASSERT_COMMSBUF();
+	__ASSERT_ALWAYS(AppendLimit() >= aSrc.Length(), CommsBuf::Panic(EMBuf_IndexOutofRange));	
+	Mem::Copy(const_cast<TUint8*>(Ptr()) + iCommsBufMetaData.iLength, aSrc.Ptr(), aSrc.Length());
+	AdjustDataEnd(aSrc.Length());
+	}
+
+EXPORT_C void RCommsBuf::Prepend(const TDesC8& aSrc)
+/**
+Prepend data onto the beginning of RCommsBuf data. The length and offset of the
+will be adjusted to reflect the new content
+
+@param aSrc Data to append
+*/
+	{
+	__ASSERT_COMMSBUF();
+    __ASSERT_ALWAYS(PrependLimit() >= aSrc.Length(), CommsBuf::Panic(EMBuf_IndexOutofRange));	
+	Mem::Copy(const_cast<TUint8*>(Ptr()) - aSrc.Length(), aSrc.Ptr(), aSrc.Length());
+	SetDataRange(Offset() - aSrc.Length(), iCommsBufMetaData.iLength + aSrc.Length());
+	}
+
+EXPORT_C void RCommsBuf::Free()
+/**
+Frees the RCommsBuf
+*/
+	{
+	Pool()->Pond().Free(this);
+	}
+
+EXPORT_C void RCommsBuf::Write(const TDesC8& aSrc, TInt aOffset /* =0 */)
+/**
+The supplied descriptor will be written to the specified offset within the RCommsBuf data
+
+@param aSrc		Data to be written
+@param aOffset	Offset within the CommsBuf
+
+@panic MBuf::11 If the given offset is negative
+*/
+	{
+	__ASSERT_COMMSBUF();
+    __ASSERT_ALWAYS(aOffset>=0, CommsBuf::Panic(EMBuf_NegativeOffset));
+    SetDataRange(aOffset, 0); // Set the write offset and make the length as 0
+  	Append(aSrc);	// Append the data
+	}
+
+EXPORT_C void RCommsBuf::Read(TDes8& aDest, TInt aOffset /* =0 */) const	
+/**
+The supplied descriptor will be read from the specified offset within the RCommsBuf data
+
+@param aDes		Descriptor to write
+@param aOffset 	The offset
+
+@panic MBuf::11 If the given offset is negative or greater than the length of the CommsBuf data
+*/
+	{
+	__ASSERT_COMMSBUF();
+    __ASSERT_ALWAYS(aOffset>=0 && aOffset<Length(), CommsBuf::Panic(EMBuf_BadOffset));
+	TPtr8 src(const_cast<TUint8*>(Ptr()) + aOffset, Length() - aOffset, Length() - aOffset);
+	aDest.Copy(src);
+	}
+