UTIL_SortIntegersByKey

function

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

Declaration

define function UTIL_SortIntegersByKey
   modifiable integer intshelf

Argument definitions

intshelf: is a keyed shelf of integers

Purpose

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