// Copyright (c) 2001-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 <delimitedpath8.h>

 #include <delimitedpath16.h>

 #include <escapeutils.h>

 //

 //

 // Implemetation of CDelimitedPath8

 //

 //

 /**

 	Static factory constructor. Uses two phase construction and leaves 

 	nothing on the CleanupStack. 

 	@param			aPath	A descriptor with the initial path.

 	@return			A pointer to the newly created object. 

  */

 EXPORT_C CDelimitedPath8* CDelimitedPath8::NewL(const TDesC8& aPath)

 	{

 	CDelimitedPath8* self = NewLC(aPath);

 	CleanupStack::Pop(self);

 	return self;

 	}

 /**

 	Static factory constructor. Uses two phase construction and leaves a pointer 

 	to created object on the CleanupStack. 

 	@param			aPath	A descriptor with the initial path.

 	@return			A pointer to the newly created object.

  */

 EXPORT_C CDelimitedPath8* CDelimitedPath8::NewLC(const TDesC8& aPath)

 	{

 	CDelimitedPath8* self = new (ELeave) CDelimitedPath8;

 	CleanupStack::PushL(self);

 	self->ConstructL(aPath);

 	return self;

 	}

 /**

 	Destructor. 

 */

 EXPORT_C CDelimitedPath8::~CDelimitedPath8()

 	{

 	}

 /**

 	Escape encodes the segment then inserts the escaped version in a position before 

 	the current parsed segment. The new segment should only contain a single path segment, 

 	as any path delimiters in the segment will be converted to an escape triple. 

 	The parser is left in a state where its current segment is the same one as before the insertion.

 	@pre	The path must have been initially parsed.

 	@param	aSegment	A descriptor with the unescaped path segment.

 	@post	The path will have been extended to include the new segment. 

 			The current segment will remain as the one before the insertion.

  */

 EXPORT_C void CDelimitedPath8::InsertAndEscapeCurrentL(const TDesC8& aSegment)

 	{

 	// Create escaped version of the segment

 	HBufC8* escaped = EscapeUtils::EscapeEncodeL(aSegment, EscapeUtils::EEscapePath);

 	CleanupStack::PushL(escaped);

 	// Insert the segment

 	InsertCurrentL(*escaped);

 	// Cleanup

 	CleanupStack::PopAndDestroy(escaped);

 	}

 /**

 	Escape encodes the segment then inserts the escaped version at the back of the path. 

 	The new segment should only contain a single path segment, as any path delimiters in 

 	the segment will be converted to an escape triple. The parser is left in a state 

 	where its current segment is the same one as before the insertion. 

 	@pre	The delimiter must have been set.

 	@param	aSegment	A descriptor with the unescaped path segment.

 	@post	The path will have been extended to include the new segment

  */

 EXPORT_C void CDelimitedPath8::PushAndEscapeBackL(const TDesC8& aSegment)

 	{

 	// Create escaped version of the segment

 	HBufC8* escaped = EscapeUtils::EscapeEncodeL(aSegment, EscapeUtils::EEscapePath);

 	CleanupStack::PushL(escaped);

 	// Insert the segment

 	PushBackL(*escaped);

 	// Cleanup

 	CleanupStack::PopAndDestroy(escaped);

 	}

 /**

 	Escape encodes the segment then inserts the escaped version at the front of the path. 

 	The new segment should only contain a single path segment, as any path delimiters in 

 	the segment will be converted to an escape triple. The parser is left in a state where 

 	its current segment is the same one as before the insertion. 

 	@pre	The delimiter must have been set. 

 	@param	aSegment	A descriptor with the unescaped path segment.

 	@post	The path will have been extended to include the new segment

  */

 EXPORT_C void CDelimitedPath8::PushAndEscapeFrontL(const TDesC8& aSegment)

 	{

 	// Create escaped version of the segment

 	HBufC8* escaped = EscapeUtils::EscapeEncodeL(aSegment, EscapeUtils::EEscapePath);

 	CleanupStack::PushL(escaped);

 	// Insert the segment

 	PushFrontL(*escaped);

 	// Cleanup

 	CleanupStack::PopAndDestroy(escaped);

 	}

 /**

 	Constructor.

 */

 CDelimitedPath8::CDelimitedPath8()

 : CDelimitedDataBase8()

 	{

 	}

 /**

 	Second phase of two-phase construction method. Does any allocations required to fully construct 

 	the object.

 	@param			aPath	A descriptor with the initial string.

 	@pre 			First phase of construction is complete.

 	@post			The object is fully constructed.

 */

 void CDelimitedPath8::ConstructL(const TDesC8& aPath)

 	{

 	// Call base class ConstructL()

 	CDelimitedDataBase8::ConstructL(aPath);

 	// Set the delimiter to '/'

 	SetDelimiter(TChar('/'));

 	}

 //

 //

 // Implemetation of CDelimitedPath16

 //

 //

 /**

 	Static factory constructor. Uses two phase construction and leaves nothing on 

 	the CleanupStack.

 	@since			6.0

 	@param			aPath	A descriptor with the initial path.

 	@return			A pointer to created object.

 	@post			Nothing left on the CleanupStack.

  */

 EXPORT_C CDelimitedPath16* CDelimitedPath16::NewL(const TDesC16& aPath)

 	{

 	CDelimitedPath16* self = NewLC(aPath);

 	CleanupStack::Pop(self);

 	return self;

 	}

 /**

 	Static factory constructor. Uses two phase construction and leaves a pointer to 

 	created object on the CleanupStack.

 	@since			6.0

 	@param			aPath	A descriptor with the initial path.

 	@return			A pointer to created object.

 	@post			Pointer to created object left of CleanupStack.

 */

 EXPORT_C CDelimitedPath16* CDelimitedPath16::NewLC(const TDesC16& aPath)

 	{

 	CDelimitedPath16* self = new (ELeave) CDelimitedPath16;

 	CleanupStack::PushL(self);

 	self->ConstructL(aPath);

 	return self;

 	}

 /**

 	Destructor.

 	@since			6.0

 */

 EXPORT_C CDelimitedPath16::~CDelimitedPath16()

 	{

 	}

 /**

 	Escape encodes the segment then inserts the escaped version in a position before the 

 	current parsed segment. The new segment should only contain a single path segment, as 

 	any path delimiters in the segment will be converted to an escape triple. The parser 

 	is left in a state where its current segment is the same one as before the insertion.

 	@since			6.0

 	@param			aSegment	A descriptor with the unescaped path segment.

 	@pre 			The path must have been initially parsed.

 	@post			The path will have been extended to include the new segment. The 

 	current segment will remain as the one before the insertion.

 */

 EXPORT_C void CDelimitedPath16::InsertAndEscapeCurrentL(const TDesC16& aSegment)

 	{

 	// Need to convert to utf8 first

 	HBufC8* utf8 = EscapeUtils::ConvertFromUnicodeToUtf8L(aSegment);

 	CleanupStack::PushL(utf8);

 	// Create escaped version of component

 	HBufC8* escaped = EscapeUtils::EscapeEncodeL(*utf8, EscapeUtils::EEscapePath);

 	CleanupStack::PushL(escaped);

 	// Convert back to 16-bits

 	HBufC16* converted = HBufC16::NewLC(escaped->Length());

 	converted->Des().Copy(*escaped);

 	// Insert the segment

 	InsertCurrentL(*converted);

 	// Cleanup

 	CleanupStack::PopAndDestroy(3, utf8);	// utf8, escaped, converted

 	}

 /**

 	Escape encodes the segment then inserts the escaped version at the back of the path. 

 	The new segment should only contain a single path segment, as any path delimiters in 

 	the segment will be converted to an escape triple. The parser is left in a state where 

 	its current segment is the same one as before the insertion.

 	@warning		A re-parse is required to ensure that the parser is valid.

 	@since			6.0

 	@param			aSegment	A descriptor with the unescaped path segment.

 	@pre 			The delimiter must have been set. 

 	@post			The path will have been extended to include the new segment.

 */

 EXPORT_C void CDelimitedPath16::PushAndEscapeBackL(const TDesC16& aSegment)

 	{

 	// Need to convert to utf8 first

 	HBufC8* utf8 = EscapeUtils::ConvertFromUnicodeToUtf8L(aSegment);

 	CleanupStack::PushL(utf8);

 	// Create escaped version of component

 	HBufC8* escaped = EscapeUtils::EscapeEncodeL(*utf8, EscapeUtils::EEscapePath);

 	CleanupStack::PushL(escaped);

 	// Convert back to 16-bits

 	HBufC16* converted = HBufC16::NewLC(escaped->Length());

 	converted->Des().Copy(*escaped);

 	// Insert the segment

 	PushBackL(*converted);

 	// Cleanup

 	CleanupStack::PopAndDestroy(3, utf8);	// utf8, escaped, converted

 	}

 /**

 	Escape encodes the segment then inserts the escaped version at the front of the path. 

 	The new segment should only contain a single path segment, as any path delimiters in 

 	the segment will be converted to an escape triple. The parser is left in a state where 

 	its current segment is the same one as before the insertion.

 	@warning		A re-parse is required to ensure that the parser is valid.

 	@since			6.0

 	@param			aSegment	A descriptor with the unescaped path segment.

 	@pre 			The delimiter must have been set. 

 	@post			The path will have been extended to include the new segment.

 */

 EXPORT_C void CDelimitedPath16::PushAndEscapeFrontL(const TDesC16& aSegment)

 	{

 	// Need to convert to utf8 first

 	HBufC8* utf8 = EscapeUtils::ConvertFromUnicodeToUtf8L(aSegment);

 	CleanupStack::PushL(utf8);

 	// Create escaped version of component

 	HBufC8* escaped = EscapeUtils::EscapeEncodeL(*utf8, EscapeUtils::EEscapePath);

 	CleanupStack::PushL(escaped);

 	// Convert back to 16-bits

 	HBufC16* converted = HBufC16::NewLC(escaped->Length());

 	converted->Des().Copy(*escaped);

 	// Insert the segment

 	PushFrontL(*converted);

 	// Cleanup

 	CleanupStack::PopAndDestroy(3, utf8);	// utf8, escaped, converted

 	}

 /**

 	Constructor. First phase of two-phase construction method. Does non-allocating construction.

 	@since			6.0

 */

 CDelimitedPath16::CDelimitedPath16()

 : CDelimitedDataBase16()

 	{

 	}

 /**

 	Second phase of two-phase construction method. Does any allocations required to fully construct 

 	the object.

 	@since			6.0

 	@param			aPath	A descriptor with the initial path.

 	@pre 			First phase of construction is complete.

 	@post			The object is fully constructed.

 */

 void CDelimitedPath16::ConstructL(const TDesC16& aPath)

 	{

 	// Call base class ConstructL()

 	CDelimitedDataBase16::ConstructL(aPath);

 	// Set the delimiter to '/'

 	SetDelimiter(TChar('/'));

 	}