Library: General, Sorting (OMSORT) Import: omsort.xmd

Declaration

  define overloaded function sort.sort-by-value
     modifiable integer shelf-to-sort

  define overloaded function sort.sort-by-value
     modifiable stream shelf-to-short

Argument definitions

shelf-to-sort

is a shelf of integers or a shelf of streams

Use sort.sort-by-value to sort a shelf of integers or streams by their values in ascending order.

This example sorts a list of integers:

  import "omsort.xmd" prefixed by sort.
  process
     local integer integer-list variable initial {1,3,2}
     sort.sort-by-value integer-list

     repeat over integer-list
       output "d" % integer-list || "%n"
     again

This example sorts a list of stream values:

  import "omsort.xmd" prefixed by sort.
  process
     local stream my-stream variable initial
        {"foo", "bar", "sna"}

     sort.sort-by-value my-stream

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

Requirements

If shelf-to-sort is a stream shelf, then it 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)

Related Syntax    sort.sort-by-key    UTIL_SortStreamsByValue    UTIL_SortStreamsByKey    UTIL_SortSwitchesByKey

Other Library Functions    sort.omsort-version    sort.sort-by-key    sort.sort-by-value

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