NAME

mtext_push_prop - Push a text property.

SYNOPSIS

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

DESCRIPTION

Push a text property.

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

COPYRIGHT