man mtext_coll () - Compare two M-texts using the current locale.

NAME

mtext_coll - Compare two M-texts using the current locale.

SYNOPSIS

int mtext_coll (MText * mt1, MText * mt2)

DESCRIPTION

The mtext_coll() function compares the two M-texts mt1 and mt2. It returns an integer less than, equal to, or greater than zero if mt1 is found, respectively, to be less than, to match, or to be greater than mt2. The comparison is based on texts as appropriate for the current locale (LC_COLLATE).

This function makes use of information that is automatically cached in the M-texts as a text property. So, the second call of this function with mt1 or mt2 finishes faster than the first call.