Class CharArrayIndirectPriorityQueue

  • All Implemented Interfaces:
    CharIndirectPriorityQueue, IndirectPriorityQueue<Character>

    public class CharArrayIndirectPriorityQueue
    extends Object
    implements CharIndirectPriorityQueue
    A type-specific array-based semi-indirect priority queue.

    Instances of this class use as reference list a reference array, which must be provided to each constructor, and represent a priority queue using a backing array of integer indices—all operations are performed directly on the array. The array is enlarged as needed, but it is never shrunk. Use the trim() method to reduce its size, if necessary.

    This implementation is extremely inefficient, but it is difficult to beat when the size of the queue is very small. Moreover, it allows to enqueue several time the same index, without limitations.

    • Constructor Detail

      • CharArrayIndirectPriorityQueue

        public CharArrayIndirectPriorityQueue​(char[] refArray,
                                              int capacity,
                                              CharComparator c)
        Creates a new empty queue without elements with a given capacity and comparator.
        Parameters:
        refArray - the reference array.
        capacity - the initial capacity of this queue.
        c - the comparator used in this queue, or null for the natural order.
      • CharArrayIndirectPriorityQueue

        public CharArrayIndirectPriorityQueue​(char[] refArray,
                                              int capacity)
        Creates a new empty queue with given capacity and using the natural order.
        Parameters:
        refArray - the reference array.
        capacity - the initial capacity of this queue.
      • CharArrayIndirectPriorityQueue

        public CharArrayIndirectPriorityQueue​(char[] refArray,
                                              CharComparator c)
        Creates a new empty queue with capacity equal to the length of the reference array and a given comparator.
        Parameters:
        refArray - the reference array.
        c - the comparator used in this queue, or null for the natural order.
      • CharArrayIndirectPriorityQueue

        public CharArrayIndirectPriorityQueue​(char[] refArray)
        Creates a new empty queue with capacity equal to the length of the reference array and using the natural order.
        Parameters:
        refArray - the reference array.
      • CharArrayIndirectPriorityQueue

        public CharArrayIndirectPriorityQueue​(char[] refArray,
                                              int[] a,
                                              int size,
                                              CharComparator c)
        Wraps a given array in a queue using a given comparator.

        The queue returned by this method will be backed by the given array.

        Parameters:
        refArray - the reference array.
        a - an array of indices into refArray.
        size - the number of elements to be included in the queue.
        c - the comparator used in this queue, or null for the natural order.
      • CharArrayIndirectPriorityQueue

        public CharArrayIndirectPriorityQueue​(char[] refArray,
                                              int[] a,
                                              CharComparator c)
        Wraps a given array in a queue using a given comparator.

        The queue returned by this method will be backed by the given array.

        Parameters:
        refArray - the reference array.
        a - an array of indices into refArray.
        c - the comparator used in this queue, or null for the natural order.
      • CharArrayIndirectPriorityQueue

        public CharArrayIndirectPriorityQueue​(char[] refArray,
                                              int[] a,
                                              int size)
        Wraps a given array in a queue using the natural order.

        The queue returned by this method will be backed by the given array.

        Parameters:
        refArray - the reference array.
        a - an array of indices into refArray.
        size - the number of elements to be included in the queue.
      • CharArrayIndirectPriorityQueue

        public CharArrayIndirectPriorityQueue​(char[] refArray,
                                              int[] a)
        Wraps a given array in a queue using the natural order.

        The queue returned by this method will be backed by the given array.

        Parameters:
        refArray - the reference array.
        a - an array of indices into refArray.