Class ImmutableArrayItem

java.lang.Object
net.sf.saxon.ma.arrays.AbstractArrayItem
net.sf.saxon.ma.arrays.ImmutableArrayItem
All Implemented Interfaces:
Callable, ArrayItem, Function, GroundedValue, Item, Sequence

public class ImmutableArrayItem extends AbstractArrayItem
Implementation of ArrayItem backed by a persistent immutable array, so that operations that "update" the array do not have to copy the whole array
  • Constructor Details

  • Method Details

    • get

      public GroundedValue get(int index)
      Get a member of the array
      Parameters:
      index - the position of the member to retrieve (zero-based)
      Returns:
      the value at the given position.
      Throws:
      IndexOutOfBoundsException - if the index is out of range
    • put

      public ArrayItem put(int index, GroundedValue newValue)
      Replace a member of the array
      Parameters:
      index - the position of the member to replace (zero-based)
      newValue - the replacement value
      Returns:
      the value at the given position.
      Throws:
      IndexOutOfBoundsException - if the index is out of range
    • insert

      public ArrayItem insert(int position, GroundedValue member)
      Insert a new member into an array
      Parameters:
      position - the 0-based position that the new item will assume
      member - the new member to be inserted
      Returns:
      a new array item with the new member inserted
      Throws:
      IndexOutOfBoundsException - if position is out of range
    • arrayLength

      public int arrayLength()
      Get the number of members in the array

      Note: the method always returns 1, because an array is an item

      Returns:
      the number of members in this array.
    • isEmpty

      public boolean isEmpty()
      Ask whether the array is empty
      Returns:
      true if and only if the size of the array is zero
    • members

      public Iterable<GroundedValue> members()
      Get the list of all members of the array
      Returns:
      an iterator over the members of the array
    • subArray

      public ArrayItem subArray(int start, int end)
      Get a subarray given a start and end position
      Parameters:
      start - the start position (zero based)
      end - the end position (the position of the first item not to be returned) (zero based)
      Returns:
      a new array item containing the sub-array
      Throws:
      IndexOutOfBoundsException - if start, or start+end, is out of range
    • concat

      public ArrayItem concat(ArrayItem other)
      Concatenate this array with another
      Parameters:
      other - the second array
      Returns:
      the concatenation of the two arrays; that is, an array containing first the members of this array, and then the members of the other array
    • remove

      public ArrayItem remove(int index)
      Remove a member from the array
      Parameters:
      index - the position of the member to be removed (zero-based)
      Returns:
      a new array in which the requested member has been removed.
      Throws:
      IndexOutOfBoundsException - if index is out of range
    • removeSeveral

      public ArrayItem removeSeveral(IntSet positions)
      Remove zero or more members from the array
      Parameters:
      positions - the positions of the members to be removed (zero-based). A value that is out of range is ignored.
      Returns:
      a new array in which the requested member has been removed