Library Functions -- $%COLLATE^CHARACTER

Approved for inclusion in a future ANSI M[UMPS] language standard as an override mechanism for collating strings.

This function returns the collating value that would apply to a string in the specified environment. The environment specified may be:

• absent, in which case the collating scheme for the current process prevails
• the name of a global variable, in which case the collating scheme for that global variable will be used
• the name of a character set profile, in which case the collating scheme for that character set profile will be used

Reference		Value
SET S="abc",A="a¤o"
SET ISO="ISO 8859-1"
$%COLLATE^CHARACTER(S,"^P")		"ABC"
$%COLLATE^CHARACTER(S)		"abc"
$%COLLATE^CHARACTER(A,ISO)		"ano000060"

In the string "ano000060", there are three parts, one for each iteration of the collation algorithm. The first part ("ano") is the "pure" character value, the second part ("000") is the upper/lower case value of the letters, and the third part ("060") is the weight of the diacritical marks.

The MDC has approved code to approximate the return value of this function. Implementors are encouraged to provide more accurate and efficient code). Click here to view or download the code for this function. Click here to view or download the code for all M[UMPS] Library Functions.

This document is © Ed de Moel, 1995-2005.
It is part of a book by Ed de Moel that is published under the title "M[UMPS] by Example" (ISBN 0-918118-42-5).
Printed copies of the book are no longer available.

This document describes the various library functions that are defined for the M[UMPS] programming language.

The information in this document is NOT authoritative and subject to be modified at any moment.
Please consult the appropriate (draft) language standard for an authoritative definition.

In this document, information is included that will appear in future standards.
The MDC cannot guarantee that these 'next' standards will indeed appear.