swirl Guide to OmniMark 6   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesOMX VariablesErrors
 
  Related Syntax     Other Library Functions  
function   UTIL_SortIntegersByKey   Available in:
Professional
Enterprise

Library: omutil - miscellaneous system utilities
Include: omutil.xin

Declaration

  define function UTIL_SortIntegersByKey
     modifiable integer intshelf
  where
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

    Related Syntax
   UTIL_SortIntegersByValue
   UTIL_SortStreamsByValue
   UTIL_SortStreamsByKey
   UTIL_SortSwitchesByKey
 
  Other Library Functions
   UTIL_Env
   UTIL_ExpRand
   UTIL_GetEnv
   UTIL_GetMilliSecondTimer
   UTIL_GetProcessId
   UTIL_IsVersionCompatible
   UTIL_LibraryVersion
   UTIL_Rand
   UTIL_Sleep
   UTIL_SortIntegersByKey
   UTIL_SortIntegersByValue
   UTIL_SortStreamsByKey
   UTIL_SortStreamsByValue
   UTIL_SortSwitchesByKey
   UTIL_Srand
   UTIL_UniformRand
 
----  

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ OMX ] [ ERRORS ]

OmniMark 6.5 Documentation Generated: December 23, 2002 at 6:25:46 pm
If you have any comments about this section of the documentation, send email to [email protected]

Copyright © OmniMark Technologies Corporation, 1988-2002.