--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/backupandrestore/backupengine/inc/sbexternalisablearray.inl	Tue Feb 02 01:11:40 2010 +0200
@@ -0,0 +1,86 @@
+// Copyright (c) 2004-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:
+// externalisablearray.inl
+// Templated RArray for serialising and deserialising simple (flat) classes
+// for transmission inside descriptors over IPC
+// 
+//
+
+/**
+ @file
+ @publishedPartner
+ @released
+*/
+
+namespace conn
+	{
+	template<class T> inline RExternalisableArray<T>* RExternalisableArray<T>::InternaliseL(const TDesC8& aExternalisedArray)
+	/**
+	Internalises an RArray of objects passed via IPC from a descriptor
+	
+	@param aExternalisedArray The descriptor passed via IPC that contains the flattened array to internalise
+	@return Pointer to a newly created RExternalisableArray
+	*/
+		{
+		RExternalisableArray<T>* self = new (ELeave) RExternalisableArray<T>;
+		
+		CleanupStack::PushL(self);
+		
+		TUint8* unpackPtr = const_cast<TUint8*>(aExternalisedArray.Ptr());
+		TInt elementCount = *reinterpret_cast<TInt*>(unpackPtr);
+		
+		// point to the start of the packed elements
+		unpackPtr += sizeof(TInt);
+		
+		for (TInt index = 0; index < elementCount; index++)
+			{
+			User::LeaveIfError(self->Append(*reinterpret_cast<T*>(unpackPtr)));
+			unpackPtr += sizeof(T);
+			}
+			
+		CleanupStack::Pop(self);
+			
+		return self;
+		}
+	
+	template<class T> inline HBufC8* RExternalisableArray<T>::ExternaliseL()
+	/**
+	Externalises an RArray of objects (not pointers) into a descriptor so that the RArray
+	may be passed via IPC
+	
+	@return Pointer to the created HBufC8
+	*/
+		{
+		// calculate the flattened size of the array
+		TInt elementSize = sizeof(T);
+		TInt count = RArray<T>::Count();
+		TInt totalPackedSize = sizeof(TInt) + (sizeof(T) * count);	// TInt stores the number of elements to be packed
+	
+		// create the HBufC8 to be returned
+		HBufC8* externalisedArray = HBufC8::NewL(totalPackedSize);
+	
+		TPtr8 buffer = externalisedArray->Des();
+	
+		// Append the number of entries to the beginning of the array
+		buffer.Append(reinterpret_cast<TUint8*>(&count), sizeof(TInt));
+	
+		// bitwise copy each entry into the buffer
+		for (TInt index = 0; index < count; index++)
+			{
+			buffer.Append(reinterpret_cast<TUint8*>(&(*this)[index]), elementSize);
+			}
+		
+		return externalisedArray;
+		}
+	}