sort.sort-by-value

function

Library: 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

Purpose

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 Topics

Other Library Functions