Button for 1977 Button for 1984 Button for 1990 Button for 1995 Button for MDC Button for notes Button for examples
Left Hand Pointer

^%COLLATE^CHARACTER

M[UMPS] by Example

Right Hand Pointer

Approved for inclusion in a future 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:

Reference   Value
Set S="abc",A="ao"    
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 for $%COLLATE^CHARACTER sample code to view or download the code for this function.
Click here for AllFunctions to view or download the code for all M[UMPS] Library Functions.

Button for 1977 Button for 1984 Button for 1990 Button for 1995 Button for MDC Button for notes Button for examples

Copyright © Standard Documents; 1977-2017 MUMPS Development Committee;
Copyright © Examples: 1995-2017 Ed de Moel;
Copyright © Annotations: 2003-2017 Jacquard Systems Research.

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

Some specifications are "approved for inclusion in a future standard". Note that the MUMPS Development Committee cannot guarantee that such future standards will indeed be published.

This page most recently updated on 13-Sep-2014, 09:14:48 .

For comments, contact Ed de Moel (demoel@jacquardsystems.com)