man mtext_put_prop () - Set a text property.

NAME

mtext_put_prop - Set a text property.

SYNOPSIS

int mtext_put_prop (MText * mt, int from, int to, MSymbol key, void * val)

DESCRIPTION

The mtext_put_prop() function sets a text property to the characters between from (inclusive) and to (exclusive) in M-text mt. key and val specify the key and the value of the text property. With this function, 

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




becomes





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





RETURN VALUE

If the operation was successful,
mtext_put_prop()
returns 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_values(),
mtext_get_prop(),
mtext_get_prop_values(),
mtext_push_prop(),
mtext_pop_prop(),
mtext_prop_range()