mtext_deserialize3m17n

Usage

Overview

@brief Deserialize text properties in an M-text.
The mtext_deserialize() function deserializes M-text @b mt.  @b mt
must be an XML having the following DTD.

<!DOCTYPE mtext [
  <!ELEMENT mtext (property*,body+)>
  <!ELEMENT property EMPTY>
  <!ELEMENT body (#PCDATA)>
  <!ATTLIST property key CDATA #REQUIRED>
  <!ATTLIST property value CDATA #REQUIRED>
  <!ATTLIST property from CDATA #REQUIRED>
  <!ATTLIST property to CDATA #REQUIRED>
  <!ATTLIST property control CDATA #REQUIRED>
 ]>

This function depends on the libxml2 library.  If the m17n library
is configured without libxml2, this function always fail.
@par Return value:
If the operation was successful, mtext_deserialize() returns the
resulting M-text.  Otherwise it returns @c NULL and assigns an error
code to the external variable #merror_code.
@par See Also:
mtext_serialize(), #Mtext_prop_deserializer