diff -r 000000000000 -r e35f40988205 xml/libxml2libs/inc/xmlengineutils/xmlengutils.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/xml/libxml2libs/inc/xmlengineutils/xmlengutils.h Thu Dec 17 09:29:21 2009 +0200 @@ -0,0 +1,68 @@ +// 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 +#include + +/** +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 + +