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

Declaration

  define function UTIL_SortStreamsByValue
     modifiable stream stream-shelf

Argument definitions

stream-shelf

is an shelf of streams

Use UTIL_SortStreamsByValue to sort a shelf of streams by their values in ascending order.

Requirements

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

  include "omutil.xin"

stream-shelf must

• not have items that are unattached, still open, or most recently attached with referents-allowed (else OmniMark Error 6059)
• not have items that were most recently attached (opened) as files or external function OMXs (else OmniMark Error 6005)

Usage Notes

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

Example

  include "omutil.xin"
  process
     local stream my-stream variable initial {"foo",
                                              "bar",
                                              "sna"}
     UTIL_SortStreamsByValue my-stream

     repeat over my-stream
        output my-stream
          || "%n"
     again

Related Syntax    sort.sort-by-value    sort.sort-by-key    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

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