Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mtext_get_prop(3m17n) [debian 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)

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