function 1: not-read


not-read:
    description:
        not-read(positions) superposition
        remove kets from the given superposition if their index is in 'positions'
        if the input is a sequence, then apply this operator for each sub-superposition
        index values start from 1, not 0
        negative values are also valid, so -1 is last element, -2 is second last element, etc
        if out of range, or not a number, return |> for that slot

    examples:
        -- a simple abstract example:
        not-read(|1> + |3> + |5>) (|one> + |two> + |three> + |four> + |five> + |six> + |seven>)
            |two> + |four> + |six> + |seven>

        -- negative indices example:
        not-read(|-1> + |-3> + |-5>) (|one> + |two> + |three> + |four> + |five> + |six> + |seven>)
            |one> + |two> + |four> + |six>

        -- if out of range, or not a number, ignore that 'position':
        -- in this example, |fish> and |11>:
        not-read(|1> + |fish> + |11> + |4>) (|one> + |two> + |three> + |four> + |five> + |six> + |seven>)
            |two> + |three> + |five> + |six> + |seven>

    see also:
        read, sread, not-sread

Home