xml/libxml2libs/inc/xmlengineutils/xmlengutils.h
changeset 0 e35f40988205
--- /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 <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&gt;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
+
+