wbxmlelm.h

是一个手机功能的模拟程序

	definition, i.e., content as its third attribute in the struct.

	NOTE! The Element MUST NOT be NULL.
	
	Input: Element (ELEMENTTYPE*)
	Output: Content (ELEMENTTYPE*), or NULL
==========================================================================*/
pELEMENTTYPE XML_GetContent (pELEMENTTYPE pElement);


/*========================================================================
	XML_CreateInlineText
==========================================================================
	The function creates a new element of type Type_Inline_Text and stores 
	the	specified string in it. If error, the ppwchString is deallocated.
	
	Input: Null-terminated string (WCHAR**)
	Output: Element or NULL
==========================================================================*/
pELEMENTTYPE XML_CreateInlineText (WCHAR** ppwchString);


/*========================================================================
	XML_CreateTableText
==========================================================================
	The function creates a new element of type Type_Table_Text and stores 
	the	specified table reference in it.
	
	Input: String table reference (UINT32)
	Output: Element or NULL
==========================================================================*/
pELEMENTTYPE XML_CreateTableText (UINT32 iTableRef);


/*========================================================================
	XML_DeleteText
==========================================================================
	The function deletes an element of type Type_Inline_Text or 
	Type_Table_Text and all data in it.

	The in-parameter ppText is set to point to NULL after the element has 
	been deleted. If the element is not of one of the above types, the
	element is left unchanged.

	Input: ELEMENTTYPE** of type Type_Inline_Text or Type_Table_Text
	Output: -
==========================================================================*/
void XML_DeleteText (pELEMENTTYPE* ppText);


/*========================================================================
	XML_CreateExt
==========================================================================
	This function is used to create an extension (EXT) element.
	
	The function creates a new element of type Type_Ext_0, Type_Ext_1, or
	Type_Ext_2 and stores the specified string in it. If error, the string 
	is deallocated.
	
	Input: WCHAR** and the type of the extension.
	Output: Element or NULL
==========================================================================*/
pELEMENTTYPE XML_CreateExt (WCHAR** ppwchString, BYTE bType);


/*========================================================================
	XML_DeleteExt
==========================================================================
	This function is used to delete any extension element.
	
	The in-parameter ppExt is set to point to NULL after the element has 
	been deleted. If the element is not an extension, the element is left 
	unchanged.	

	Input: ELEMENTTYPE** of any extension type
	Output: -
==========================================================================*/
void XML_DeleteExt (pELEMENTTYPE* ppExt);


/*========================================================================
	XML_CreateEntity
==========================================================================
	The function creates a new element of type Type_Entity and stores the
	specified entity in it.
	
	Input: UINT32 specifying the entity 
	Output: Element or NULL
==========================================================================*/
pELEMENTTYPE XML_CreateEntity (UINT32 iEntity);


/*========================================================================
	XML_DeleteEntity
==========================================================================
	The function deletes an element of type Type_Entity and all data in it.

	The in-parameter ppEntity is set to point to NULL after the element 
	has been deleted. If the element is not an entity, the element is left 
	unchanged.
  
	Input: ELEMENTTYPE** of type Type_Entity
	Output: -
==========================================================================*/
void XML_DeleteEntity (pELEMENTTYPE* ppEntity);


/*========================================================================
	XML_CreateOpaque
==========================================================================
	The function creates a new element of type Type_Opaque and stores the
	specified data in it. If error, data is deallocated.
	
	Input: Data and length.
	Output: Element or NULL
==========================================================================*/
pELEMENTTYPE XML_CreateOpaque (BYTE** ppbData, UINT32 iLength);


/*========================================================================
	XML_DeleteOpaque
==========================================================================
	The function deletes an element of type Type_Opaque and all data in it.

	The in-parameter ppEntity is set to point to NULL after the element 
	has been deleted. If the element is not an opaque element, it is left 
	unchanged.
  
	Input: ELEMENTTYPE** of type Type_Opaque
	Output: -
==========================================================================*/
void XML_DeleteOpaque (pELEMENTTYPE* ppOpaque);


/*========================================================================
	XML_GetNextElement
==========================================================================
	This function returns the next element in the list on the same level 
	as the input element.
	
	Input: Element
	Output: Element, NULL if no more elements
==========================================================================*/
pELEMENTTYPE XML_GetNextElement (pELEMENTTYPE pElement);


/*========================================================================
	XML_DeleteElement
==========================================================================
	This function deletes an element and deallocates all memory. The 
	function uses the function pointer DTD_DeleteElement. 

	The in-parameter ppElement is set to point to NULL after the element
	has been deleted.

	Input: ELEMENTTYPE**, and pWBXMLDECODESTR.
	Output: -
==========================================================================*/
void XML_DeleteElement (pELEMENTTYPE* ppElement, pWBXMLDECODESTR pDecStr);


/*========================================================================
	XML_DeleteElementList
==========================================================================
	This function deletes a list of elements (and deallocates all memory) 
	starting with the specified element. The function uses the function 
	XML_DeleteElement.

	The in-parameter ppElement is set to point to NULL after the element
	list has been deleted.

	Input: ELEMENTTYPE**, and pWBXMLDECODESTR.
	Output: -
==========================================================================*/
void XML_DeleteElementList (pELEMENTTYPE* ppElement, pWBXMLDECODESTR pDecStr);


/*========================================================================
	XML_AddElementToHead
==========================================================================
	This function stores the specified element at the start of the element 
	list. 

	Input: Element List and element
	Output: -
==========================================================================*/
void XML_AddElementToHead (pELEMENTTYPE* ppElementList, pELEMENTTYPE pElement);


/*========================================================================
	XML_AddElementToEnd
==========================================================================
	This function stores the specified element at the end of the element 
	list. 

	Input: Element List and element
	Output: -
==========================================================================*/
void XML_AddElementToEnd (pELEMENTTYPE* ppElementList, pELEMENTTYPE pElement);


#endif