sequence function: sread-range

    description:
        sread-range(start-idx, finish-idx) input-seq
        the sequence read-range function
        acts just like sselect[a,b] except a and b are now kets, not constants.
        is also almost the same as: sread(range(start-idx, finish-idx)) input-seq
        but there are some differences. eg, sread-range can handle negative indices too.
        index values start at 1, not 0. So 1 is the first element, 2 is the 2nd element, and so on.
        negative index values work too. eg, -1 is the last element in the sequence, -2 is the 2nd last, and so on.
        if the index value is > length of input-seq, then those index values are ignored

    examples:
        -- standard usage:
        sread-range(|2>, |5>) ssplit |abcdefgh>
            |b> . |c> . |d> . |e>
        
        -- with negative index value:
        sread-range(|2>, |-3>) ssplit |abcdefgh>
            |b> . |c> . |d> . |e> . |f>

    see also:
        sread, swrite, swrite-range, sselect


Home