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¶

SEE ALSO¶

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>.