---
name: "mtext_prop_range"
section: "3m17n"
platform: "linux"
package: "m17n-docs"
version: "1.8.4-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mtext_prop_range"
---

# mtext\_prop\_range(3m17n)

## NAME

mtext\_prop\_range -

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