// Copyright (c) 2005-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:

// This file contains methods allow to change XmlChar to TDesC

// and TDesC to XmlChar

//

/**

 @file

 @publishedPartner

 @released

*/

#ifndef XMLENGUTILS_H

#define XMLENGUTILS_H

#include <string.h>

#include <e32base.h>

/**

Converts a xml string that may contains entities to a xml string

with entity references, i.e. "t>x" -> "t>x"

@param aUnescapedString The string to escape

@return The escaped string.  Ownership is transferred to the caller.  The

returned string should be freed with free().

@leave KErrNoMemory Memory allocation error

@leave - Otherwise any other system wide error code

*/

IMPORT_C char* XmlEngEscapeForXmlValueL(const char* aUnescapedString);

/**

Convert a UTF-16 descriptor into a UTF-8 zero-terminated string

@param aDes The descriptor to convert

@return The returned string.  Ownership is transferred to the caller.  The

returned string should be freed with delete. 

@leave KErrNoMemory Memory allocation error

@leave - Otherwise any other system wide error code

*/

IMPORT_C char* XmlEngXmlCharFromDesL(const TDesC& aDes);

/**

Convert a TDesC8 descriptor with UTF-8 characters into a UTF-8 zero-terminated

string.

@param aDes The descriptor to convert

@return The returned string.  Ownership is transferred to the caller.  The

returned string should be freed with delete.

@leave KErrNoMemory Memory allocation error

@leave - Otherwise any other system wide error code

*/

IMPORT_C char* XmlEngXmlCharFromDes8L(const TDesC8& aDes);

#endif // XMLENGUTILS_H