// Copyright (c) 1995-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of the License "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:

// e32test\buffer\t_des.cpp

// Overview:

// Test methods of the TDes template class.

// API Information:

// TDes

// Details:

// - Test assigning TPtrs in various ways and confirm results are as expected.

// - Test locating in reverse on an empty TPtr, verify it returns KErrNoFound.

// - For TBuf, TBuf8 and TBuf16 objects: 

// - Construct a default TBuf object and verify Length and MaxLength values are

// as expected.

// - Construct a TBuf object with length and verify Length and MaxLength values 

// are as expected.

// - Construct a TBuf object over a string, verify Length and MaxLength values 

// are as expected. Verify the string data is correct.

// - Construct a TBuf object over a descriptor, verify Length and MaxLength values 

// are as expected. Verify the data is correct.

// - Construct a TBuf object over a buffer, verify Length and MaxLength values 

// are as expected. Verify the data is correct.

// - Construct a TBuf object and assign a string to it, verify Length and MaxLength 

// values are as expected. Verify the data is correct.

// - Construct a TBuf object and assign a descriptor to it, verify Length and MaxLength 

// values are as expected. Verify the data is correct.

// - Construct a TBuf object and assign a buffer to it, verify Length and MaxLength 

// values are as expected. Verify the data is correct.

// - Check the available user heap space and check for memory leaks by comparing it to 

// the initial value.

// - For TPtrC, TPtrC8 and TPtrC16 objects: 

// - Verify the invariant for a null pointer descriptor

// - Construct a TPtrC object over a constant string, verify Length and string data 

// are correct.

// - Construct a TPtrC object over a constant descriptor, verify Length and data are 

// correct.

// - Construct a TPtrC object over a constant buffer with length, verify Length and 

// data are correct.

// - Check the available user heap space and check for memory leaks by comparing it to 

// the initial value.

// - For TPtr, TPtr8 and TPtr16 objects: 

// - Verify the invariant for a null pointer descriptor

// - Construct a TPtr object over a buffer with length and maxlength, verify Length,

// MaxLength and data are correct.

// - Construct a TPtr object over a buffer with maxlength, verify Length, MaxLength 

// and Ptr are correct.

// - Construct a TPtr object and assign a string to it. Verify Length, MaxLength and

// the string data are correct.

// - Construct a TPtr object and assign a buffer to it. Verify Length, MaxLength and

// the data are correct.

// - Construct a TPtr object and assign a descriptor to it. Verify Length, MaxLength

// and the data are correct.

// - Check the available user heap space and check for memory leaks by comparing it to 

// the initial value.

// - Verify the TPtr copy constructor by setting and checking a text string.

// - For TBufC, TBufC8 and TBufC16 objects: 

// - Construct a default TBufC object. Verify default Length is as expected.

// - Construct a TBufC object over a string, verify Length and data are correct.

// - Construct a TBufC object over a TBufC, verify Length and data are correct.

// - Construct a TBufC object and assign a string to it, verify Length and data 

// are correct.

// - Construct a TBufC object and assign a descriptor to it, verify Length and data 

// are correct.

// - Construct a TBufC object and assign a TBufC to it, verify Length and data 

// are correct.

// - Check the available user heap space and check for memory leaks by comparing it to 

// the initial value.

// - For HBufC, HBufC8 and HBufC16 objects: 

// - Create a new descriptor using the New() method, verify non-NULL return value.

// - Construct a HBufC object and assign a string to it, verify Length and data 

// are correct.

// - Construct a HBufC object and assign a descriptor to it, verify Length and data 

// are correct.

// - Construct a HBufC object and assign a HBufC to it, verify Length and data 

// are correct.

// - Construct a HBufC object and call ReAlloc method, verify Length and data are 

// correct.

// - Check the available user heap space and check for memory leaks by comparing it to 

// the initial value.

// - Test ASCII destination with Unicode source. Verify string results are as expected.

// - For TLitC, TLitC8 and TLitC16 objects: 

// - Verify member operators.

// - Assign and validate literal values

// - For TBuf, TBuf8 and TBuf16 objects, test TDes derived objects that return TPtrs.

// - Extract and verify the left portion of the descriptor (LeftTPtr).

// - Extract and verify the right portion of the descriptor (RightTPtr).

// - Extract and verify the middle portion of the descriptor (MidTPtr).

// - For TPtr, TPtr8 and TPtr16 objects, test TDes derived objects that return TPtrs.

// - Extract and verify the left portion of the descriptor (LeftTPtr).

// - Extract and verify the right portion of the descriptor (RightTPtr).

// - Extract and verify the middle portion of the descriptor (MidTPtr).

// Platforms/Drives/Compatibility:

// All 

// Assumptions/Requirement/Pre-requisites:

// Failures and causes:

// Base Port information:

// 

//

#include <e32test.h>

LOCAL_D RTest test(_L("T_DES"));

template<class T,class S, class L, class R>	

class TestTDes

	{

public:

	TestTDes(); 		// Test class constructor.

	void Test1();

	void Test2();

	void Test3();

	void Test4();

	void Test5();

	void Test6();

	void Test7();

	void Test8();

	void Test9();

	void Test10();

	void Test11();

	void Test12();

	void Test13();

	void Test14();

	void Test15();

	void Test16();

	void Test17();

	void Test18();

	void TestA();

	void TestB();

	void TestC();

	void TestD();

	void TestE();

	void TestF();

	void TestG();

	void TestH();

	void TestI();

	void TestJ();

	void TestK();

	void TestL();

	void TestM();

	void TestN();

	void TestO();

	void TestP();

	void test_TPtrC(); 	// Test TPtrC classes

	void test_TPtr();	// Test TPtr classes

	void test_TBuf();	// Test TBuf classes

	void test_TBufC();	// Test TBufC classes

	void test_HBufC();	// Test HBufC classes

	void test_TBufReturningModifiable();

	void test_TPtrReturningModifiable();

	void test_TDesReturningModifiable(const T& a, R& b);

	void testHeapSpace(TInt);

	};

template <class T, class S, class L, class R>

GLDEF_C TestTDes<T,S,L,R>::TestTDes()

//

//	Constructor

//

	{}

template <class T,class S,class L,class R>

GLDEF_C void TestTDes<T,S,L,R>::testHeapSpace(TInt startAvail)

//

//	Test no memory leakage has occured

//

	{

	test.Next(_L("Testing for memory leaks"));

	TInt endAvail,temp;

	endAvail=User::Available(temp);

	test(endAvail==startAvail);

	}

template <class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::Test1()

//

//	Constructs a view over a constant string

//

	{

	T a(_TL("ABc"));

	a.__DbgTestInvariant();

	test(a.Length()==3);

	test(*a.Ptr()=='A');

	test(*(a.Ptr()+1)=='B');

	test(*(a.Ptr()+2)=='c');

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::Test2()

//

//	Constructs a view over a descriptor

//

	{

	T aDes(_TL("ABc"));

	aDes.__DbgTestInvariant();

	T b(aDes);

	b.__DbgTestInvariant();

	test(b.Length()==aDes.Length());

	test(*b.Ptr()==*aDes.Ptr());

	test(*(b.Ptr()+1)==*(aDes.Ptr()+1));

	test(*(b.Ptr()+2)==*(aDes.Ptr()+2));

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::Test3()

//

//	Constructs a view over a length specified buffer

//

	{

	S* aBuf = _TL("ABCDEF");

	T aDes(aBuf,6);

	aDes.__DbgTestInvariant();

	test(aDes.Length()==6);

	for(S count=0; count<aDes.Length(); count++)

		test(*(aDes.Ptr()+count)==('A' + count));

	test(aDes.Ptr()==aBuf);

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::Test4()

//

//	Constructs a r/w view over a buffer with length & maxlength

//

	{

	S* aBuf;

	aBuf=_TL("LMNOPQ");

	T aDesW(aBuf,6,0x0A);

	aDesW.__DbgTestInvariant();

	test(aDesW.Length()==6);

	for(S count=0; count<aDesW.Length(); count++)

		test(*(aDesW.Ptr()+count)==('L' + count));

	test(aDesW.Ptr()==aBuf);

	test(aDesW.MaxLength()==0x0A);

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::Test5()

//

//	Constructs a r/w view over a buffer with maxlength

//

	{

	S* aBuf;

	aBuf=_TL("ZYXWVU");

	T aDesW(aBuf,0x06);

	aDesW.__DbgTestInvariant();

	test(aDesW.Length()==0);

	test(aDesW.MaxLength()==0x06);

	test(aDesW.Ptr()==aBuf);

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::Test6()

//

//	Constructs a r/w view over a LcbBase with maxlength

//

	{

	// Cant use yet, see calling function

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::Test7()

//

//	Constructs a default TBuf view 

//

	{

	T aBuf;

	aBuf.__DbgTestInvariant();

	test(aBuf.Length()==0);

	test(aBuf.MaxLength()==0x40);

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::Test8()

//

//	Constructs a TBuf view with length

//

	{

	T aBuf(10);

	aBuf.__DbgTestInvariant();

	test(aBuf.Length()==10);

	test(aBuf.MaxLength()==0x40);

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::Test9()

//

//	Constructs a TBuf view over a string

//

	{

	T aBuf(_TL("ABCDEF"));

	aBuf.__DbgTestInvariant();

	test(aBuf.Length()==6);

	test(aBuf.MaxLength()==0x40);

	for(S count=0;count<aBuf.Length();count++)

		test(*(aBuf.Ptr()+count)==('A' + count));

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::Test10()

//

//	Constructs a TBuf view over a descriptor

//

	{

	R aDesR(_TL("ABCDEF"));

	aDesR.__DbgTestInvariant();

	T aBuf(aDesR);

	aBuf.__DbgTestInvariant();

	test(aBuf.MaxLength()==0x40);

	test(aBuf.Length()==aDesR.Length());

	test(aBuf.Length()==6);

	for(S count=0;count<aBuf.Length();count++)

		{

		test(*(aBuf.Ptr()+count)==('A' + count));

		test(*(aBuf.Ptr()+count)==*(aDesR.Ptr()+count));

		}

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::Test11()

//

//	Constructs a TBuf view over a buffer

//

	{

	T aBuf(_TL("ABCDEF"));

	aBuf.__DbgTestInvariant();

	T bBuf(aBuf);

	bBuf.__DbgTestInvariant();

	test(bBuf.MaxLength()==aBuf.MaxLength());

	test(bBuf.MaxLength()==0x40);

	test(bBuf.Length()==aBuf.Length());

	test(bBuf.Length()==6);

	for(S count=0;count<bBuf.Length();count++)

		{

		test(*(bBuf.Ptr()+count)==('A' + count));

		test(*(bBuf.Ptr()+count)==*(aBuf.Ptr()+count));

		}

	}

template<class T,class S,class L,class R>

GLDEF_C void TestTDes<T,S,L,R>::Test12()

//

//	Exercise the default TBufC constructor

//

	{

	T buf;

	buf.__DbgTestInvariant();

	test(buf.Length()==0);

	}

template<class T,class S,class L,class R>

GLDEF_C void TestTDes<T,S,L,R>::Test13()

//

//	Constructor over a string

//

	{

	S* pString=(_TL("12"));

	T buf(pString);

	buf.__DbgTestInvariant();

	test(buf.Length()==2);

	test(*(buf.Ptr())=='1');

	test(*(buf.Ptr()+1)=='2');

	}

template<class T,class S,class L,class R>

GLDEF_C void TestTDes<T,S,L,R>::Test14()

//

//	Constructor over a TDesC (TPtrC)

//

	{

	R des(_TL("Test 14"));

	des.__DbgTestInvariant();

	T buf(des);

	buf.__DbgTestInvariant();

	test(buf.Length()==7);

	test(buf.Length()==des.Length());

	test(*(buf.Ptr())=='T');

	test(*(buf.Ptr()+1)=='e');

	test(*(buf.Ptr()+2)=='s');

	test(*(buf.Ptr()+3)=='t');

	test(*(buf.Ptr()+4)==' ');

	test(*(buf.Ptr()+5)=='1');

	test(*(buf.Ptr()+6)=='4');

	}

template<class T,class S,class L,class R>

GLDEF_C void TestTDes<T,S,L,R>::Test15()

//

//	Constructor over a TBufC

//

	{

	T oldBuf(_TL("Test  15"));

	oldBuf.__DbgTestInvariant();

	T newBuf(oldBuf);

	newBuf.__DbgTestInvariant();

	test(newBuf.Length()==8);

	test(newBuf.Length()==oldBuf.Length());

	test(*(newBuf.Ptr())=='T');

	test(*(newBuf.Ptr()+1)=='e');

	test(*(newBuf.Ptr()+2)=='s');

	test(*(newBuf.Ptr()+3)=='t');

	test(*(newBuf.Ptr()+4)==' ');

	test(*(newBuf.Ptr()+5)==' ');

	test(*(newBuf.Ptr()+6)=='1');

	test(*(newBuf.Ptr()+7)=='5');

	}

template<class T,class S,class L,class R>

GLDEF_C void TestTDes<T,S,L,R>::Test16()

//

//	New operator - without leave

//

	{

	T* pBuf=T::New(0x40);

	test(pBuf!=NULL);

	pBuf->__DbgTestInvariant();

	User::Free(pBuf);

	}

template<class T,class S,class L,class R>

GLDEF_C void TestTDes<T,S,L,R>::Test17()

//

//	NewL operator - forcing a leave

//

	{

/*

    Reinstate if some method is found of forcing alloc fail

    This test no longer works due to heap growing functionality of E32 057

	T* pBuf;

	TInt temp;

	TInt available=User::Available(temp);

	TAny* pDummy=User::Alloc(available);

	TRAPD(ret,pBuf=T::NewL(0x40))

	test(ret==KErrNoMemory);

	User::Free(pDummy);

*/

	}

template<class T,class S,class L,class R>

GLDEF_C void TestTDes<T,S,L,R>::Test18()

//

//	NewL operator - forcing success

//

	{

	T* pBuf=NULL;

	TRAPD(ret,pBuf=T::NewL(0x40))

	test(ret==0);

	test(pBuf!=NULL);

	pBuf->__DbgTestInvariant();

	User::Free(pBuf);

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::TestA()

//

//	String Assignment

//

	{

    S myBuf[7];

    Mem::Copy(myBuf,_TL("ABCDEF"),7*sizeof(S));

	T aDes(myBuf,0x06,0x06);

	aDes=_TL("ZYXWVU");

	aDes.__DbgTestInvariant();

	test(aDes.Length()==6);

	test(aDes.MaxLength()==0x06);

	S count=0;

	for(;count<aDes.Length(); count++)

		{

		test(*(aDes.Ptr()+count)==('Z'-count));

		}	

	aDes=_TL("123");

	aDes.__DbgTestInvariant();

	test(aDes.Length()==3);

	test(aDes.MaxLength()==0x06);

	for(count=0; count<aDes.Length(); count++)

		{

		test(*(aDes.Ptr()+count)==('1'+count));

		}	

	}

template<class T, class S, class L, class R>

GLDEF_C void TestTDes<T,S,L,R>::TestB()

//	DesW Assignment

	{

	S aBuf[11];

	S bBuf[11];

    Mem::Copy(aBuf,_TL("ZYXWVUTSRQ"),11*sizeof(S));

    Mem::Copy(bBuf,_TL("ABCDEFGHIJ"),11*sizeof(S));

	T aDes(aBuf,0x0A,0x0A);	

	T bDes(bBuf,0x0A);

	bDes=aDes;

	aDes.__DbgTestInvariant();

 	bDes.__DbgTestInvariant();

	test(aDes.Length()==bDes.Length());

	test(aDes.MaxLength()==0x0A);

	test(bDes.MaxLength()==0x0A);