Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mtext_compare(3m17n) [debian man page]

mtext_compare(3m17n)						 The m17n Library					      mtext_compare(3m17n)

NAME

       mtext_compare - Compare specified regions of two M-texts.

SYNOPSIS

       int mtext_compare (MText * mt1, int from1, int to1, MText * mt2, int from2, int to2)

DESCRIPTION

       Compare specified regions of two M-texts. The mtext_compare() function compares two M-texts mt1 and mt2, character-by-character. The
       compared regions are between from1 and to1 in mt1 and from2 to to2 in MT2.  from1 and from2 are inclusive, to1 and to2 are exclusive.
       from1 being equal to to1 (or from2 being equal to to2) means an M-text of length zero. An invalid region specification is regarded as both
       from1 and to1 (or from2 and to2) being 0.

RETURN VALUE

	   This function returns 1, 0, or -1 if mt1 is found greater than, equal to, or less than mt2, respectively. Comparison is based on
	   character codes.

SEE ALSO

	   mtext_cmp(), mtext_ncmp(), mtext_casecmp(), mtext_ncasecmp(), mtext_case_compare()

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

Check Out this Related Man Page

mtext_pop_prop(3m17n)						 The m17n Library					     mtext_pop_prop(3m17n)

NAME

       mtext_pop_prop - Pop a text property.

SYNOPSIS

       int mtext_pop_prop (MText * mt, int from, int to, MSymbol key)

DESCRIPTION

       Pop a text property. The mtext_pop_prop() function removes the topmost text property whose key is key from the characters between from
       (inclusive) and and to (exclusive) in mt.

       This function does nothing if characters in the region have no such text property. With this function,

			   FROM 		   TO
       M-text: |<------------|-------- MT ---------|------------>|
       PROP  :	<------------------ OLD_VAL -------------------->

       becomes

			   FROM 		   TO
       M-text: |<------------|-------- MT ---------|------------>|
       PROP  :	<--OLD_VAL-->|			   |<--OLD_VAL-->|

RETURN VALUE

	   If the operation was successful, mtext_pop_prop() return 0. 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_push_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_pop_prop(3m17n)
Man Page