mtext_deserialize(3m17n) The m17n Library mtext_deserialize(3m17n)NAME
mtext_deserialize - Deserialize text properties in an M-text.
SYNOPSIS
MText* mtext_deserialize (MText * mt)
DESCRIPTION
Deserialize text properties in an M-text. The mtext_deserialize() function deserializes M-text mt. 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.
RETURN VALUE
If the operation was successful, mtext_deserialize() returns the resulting M-text. Otherwise it returns NULL and assigns an error code
to the external variable merror_code.
SEE ALSO
mtext_serialize(), Mtext_prop_deserializer
COPYRIGHT
Copyright (C) 2001 Information-technology Promotion Agency (IPA)
Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License
<http://www.gnu.org/licenses/fdl.html>.
Version 1.6.2 12 Jan 2011 mtext_deserialize(3m17n)
Check Out this Related Man Page
mtext_get_prop(3m17n) The m17n Library mtext_get_prop(3m17n)NAME
mtext_get_prop - Get the value of the topmost text property.
SYNOPSIS
void* mtext_get_prop (MText * mt, int pos, MSymbol key)
DESCRIPTION
Get the value of the topmost text property. The mtext_get_prop() function searches the character at pos in M-text mt for the text property
whose key is key.
RETURN VALUE
If a text property is found, mtext_get_prop() returns the value of the property. If the property has multiple values, it returns the
topmost one. If no such property is found, it returns NULL without changing the external variable merror_code.
If an error is detected, mtext_get_prop() returns NULL and assigns an error code to the external variable merror_code.
Note:
If NULL is returned without an error, there are two possibilities:
o the character at pos does not have a property whose key is key, or
o the character does have such a property and its value is NULL.
If you need to distinguish these two cases, use the mtext_get_prop_values() function instead.
ERRORS
MERROR_RANGE, MERROR_SYMBOL
SEE ALSO
mtext_get_prop_values(), mtext_put_prop(), mtext_put_prop_values(), mtext_push_prop(), mtext_pop_prop(), mtext_prop_range()
COPYRIGHT
Copyright (C) 2001 Information-technology Promotion Agency (IPA)
Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License
<http://www.gnu.org/licenses/fdl.html>.
Version 1.6.2 12 Jan 2011 mtext_get_prop(3m17n)