Library: Utilities (OMUTIL legacy) Include: omutil.xin

Declaration

define function UTIL_SortIntegersByKey
   modifiable integer intshelf

Argument definitions

intshelf

is a keyed shelf of integers

Use UTIL_SortIntegersByKey to sort a shelf of integers by their keys in ascending order.

Requirements

You must include the following line at the beginning of your OmniMark program:

  include "omutil.xin"

intshelf must have a key for every item (else OmniMark Error 6052).

Usage Notes

You may want to write a function to build your keyed integer shelf from your existing data.

Example

  include "omutil.xin"
  process
     local integer integer-test-shelf variable initial {1 with key "a", 
                                                        2 with key "c", 
                                                        3 with key "b"}
     UTIL_SortIntegersByKey integer-test-shelf
     
     repeat over integer-test-shelf
       output "key " 
          || key of integer-test-shelf 
          ||  "; item " 
          || "%d(integer-test-shelf)" 
          || "%n"
     again

Other Library Functions

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]