man mtext_push_prop () - Push a text property.
NAME
mtext_push_prop - Push a text property.
SYNOPSIS
int mtext_push_prop (MText * mt, int from, int to, MSymbol key, void * val)
DESCRIPTION
The mtext_push_prop() function pushes a text property whose key is key and value is val to the characters between from (inclusive) and to (exclusive) in M-text mt. With this function,
FROM TO M-text: |<------------|-------- MT ---------|------------>| PROP : <------------------ OLD_VAL -------------------->
becomes
FROM TO
M-text: |<------------|-------- MT ---------|------------>|
PROP : <------------------- OLD_VAL ------------------->
PROP : <-------- VAL ------->
RETURN VALUE
If the operation was successful, mtext_push_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(), mtext_put_prop_values(), mtext_get_prop(), mtext_get_prop_values(), mtext_pop_prop(), mtext_prop_range()