Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mtext_prop_range(3m17n) [debian man page]

mtext_prop_range(3m17n) 					 The m17n Library					   mtext_prop_range(3m17n)

NAME

       mtext_prop_range - Find the range where the value of a text property is the same.

SYNOPSIS

       int mtext_prop_range (MText * mt, MSymbol key, int pos, int * from, int * to, int deeper)

DESCRIPTION

       Find the range where the value of a text property is the same. The mtext_prop_range() function investigates the extent where all characters
       have the same value for a text property. It first finds the value of the property specified by key of the character at pos in M-text mt.
       Then it checks if adjacent characters have the same value for the property key.	The beginning and the end of the found range are stored to
       the variable pointed to by from and to.	The character position stored in from is inclusive but that in to is exclusive; this fashion is
       compatible with the range specification in the mtext_put_prop() function, etc.

       If deeper is not 0, not only the topmost but also all the stacked properties whose key is key are compared.

       If from is NULL, the beginning of range is not searched for. If to is NULL, the end of range is not searched for.

RETURN VALUE

       If the operation was successful, mtext_prop_range() returns the number of values the property key has at pos. Otherwise it returns -1 and
       assigns an error code to the external variable merror_code.

ERRORS

	   MERROR_RANGE, MERROR_SYMBOL

SEE ALSO

	   mtext_put_prop(), mtext_put_prop_values(), mtext_get_prop(), mtext_get_prop_values(), mtext_pop_prop(), mtext_push_prop()

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_prop_range(3m17n)

Check Out this Related Man Page

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)
Man Page