A NumberedSet is a generic container of Objects where each element is identified by an integer id. : Set « Collections Data Structure « Java






A NumberedSet is a generic container of Objects where each element is identified by an integer id.

      
/*
 *  Tiled Map Editor, (c) 2004-2006
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  Adam Turk <aturk@biggeruniverse.com>
 *  Bjorn Lindeijer <bjorn@lindeijer.nl>
 */

//package tiled.util;

import java.util.Iterator;
import java.util.Vector;

/**
 * A NumberedSet is a generic container of Objects where each element is
 * identified by an integer id. Unlike with a Vector, the mapping between id and
 * element remains unaffected when elements are deleted. This means that the set
 * of ids for a NumberedSet may not be contiguous. (A sparse array)
 * 
 * @author rainerd
 */
public class NumberedSet {
  private Vector data;

  /**
   * Constructs a new empty NumberedSet.
   */
  public NumberedSet() {
    data = new Vector();
  }

  /**
   * Returns the element for a specific element, or null if the id does not
   * identify any element in this NumberedSet.
   * 
   * @param id
   * @return Object
   */
  public Object get(int id) {
    try {
      return data.get(id);
    } catch (ArrayIndexOutOfBoundsException e) {
    }

    return null;
  }

  /**
   * Returns true if the NumberedSet contains an element for the specified id.
   * 
   * @param id
   * @return boolean
   */
  public boolean containsId(int id) {
    return get(id) != null;
  }

  /**
   * Sets the element for the specified id, replacing any previous element
   * that was associated with that id. id should be a relatively small
   * positive integer.
   * 
   * @param id
   * @param o
   * @return int
   * @throws IllegalArgumentException
   */
  public int put(int id, Object o) throws IllegalArgumentException {
    if (id < 0)
      throw new IllegalArgumentException();

    // Make sure there is sufficient space to overlay
    for (int i = id - data.size(); i > 0; i--) {
      data.add(null);
    }

    data.add(id, o);
    return id;
  }

  /**
   * Removes the element associated with the given id from the NumberedSet.
   * 
   * todo: this function shifts the ids of any subsequent elements!
   * 
   * @param id
   */
  public void remove(int id) {
    data.remove(id);
  }

  /**
   * Returns the last id in the NumberedSet that is associated with an
   * element, or -1 if the NumberedSet is empty.
   * 
   * @return int
   */
  public int getMaxId() {
    int maxId = data.size() - 1;

    while (maxId >= 0) {
      if (data.get(maxId) != null) {
        break;
      }
      maxId--;
    }

    return maxId;
  }

  /**
   * Returns an iterator to iterate over the elements of the NumberedSet.
   * 
   * @return NumberedSetIterator
   */
  public Iterator iterator() {
    return data.iterator();
  }

  /**
   * Adds a new element to the NumberedSet and returns its id.
   * 
   * @param o
   * @return int
   */
  public int add(Object o) {
    int id = getMaxId() + 1;
    put(id, o);
    return id;
  }

  /**
   * Returns the id of the first element of the NumberedSet that is euqal to
   * the given object, or -1 otherwise.
   * 
   * @param o
   */
  public int indexOf(Object o) {
    return data.indexOf(o);
  }

  /**
   * Returns true if at least one element of the NumberedSet is equal to the
   * given object.
   */
  public boolean contains(Object o) {
    return data.contains(o);
  }

  /**
   * If this NumberedSet already contains an element equal to the given
   * object, return its id. Otherwise insert the given object into the
   * NumberedSet and return its id.
   */
  public int findOrAdd(Object o) {
    int id = indexOf(o);
    if (id != -1)
      return id;
    return add(o);
  }

  /**
   * Returns the number of actual elements in the NumberedSet.
   * 
   * @return int
   */
  public int size() {
    return data.size();
  }
}

   
    
    
    
    
    
  








Related examples in the same category

1.Set, HashSet and TreeSet
2.Things you can do with SetsThings you can do with Sets
3.Set operations: union, intersection, difference, symmetric difference, is subset, is superset
4.Set implementation that use == instead of equals()
5.Set that compares object by identity rather than equality
6.Set union and intersection
7.Set with values iterated in insertion order.
8.Putting your own type in a SetPutting your own type in a Set
9.Use setUse set
10.Another Set demo
11.Set subtractionSet subtraction
12.Working with HashSet and TreeSetWorking with HashSet and TreeSet
13.TreeSet DemoTreeSet Demo
14.Show the union and intersection of two sets
15.Demonstrate the Set interface
16.Array Set extends AbstractSetArray Set extends AbstractSet
17.Sync Test
18.Set Copy
19.Set and TreeSet
20.Tail
21.What you can do with a TreeSetWhat you can do with a TreeSet
22.Remove all elements from a set
23.Copy all the elements from set2 to set1 (set1 += set2), set1 becomes the union of set1 and set2
24.Remove all the elements in set1 from set2 (set1 -= set2), set1 becomes the asymmetric difference of set1 and set2
25.Get the intersection of set1 and set2, set1 becomes the intersection of set1 and set2
26.Extend AbstractSet to Create Simple Set
27.Int Set
28.One Item Set
29.Small sets whose elements are known to be unique by construction
30.List Set implements Set
31.Converts a char array to a Set
32.Converts a string to a Set
33.Implements the Set interface, backed by a ConcurrentHashMap instance
34.An IdentitySet that uses reference-equality instead of object-equality
35.An implementation of the java.util.Stack based on an ArrayList instead of a Vector, so it is not synchronized to protect against multi-threaded access.
36.A thin wrapper around a List transforming it into a modifiable Set.
37.A thread-safe Set that manages canonical objects
38.This program uses a set to print all unique words in System.in
39.Indexed Set
40.An ObjectToSet provides a java.util.Map from arbitrary objects to objects of class java.util.Set.
41.Sorted Multi Set
42.Fixed Size Sorted Set
43.Set operations
44.Set which counts the number of times a values are added to it.
45.Set which counts the number of times a values are added to it and assigns them a unique positive index.
46.Indexed Set
47.A set acts like array.
48.Implements a Bloom filter. Which, as you may not know, is a space-efficient structure for storing a set.
49.Implementation of disjoint-set data structure
50.Call it an unordered list or a multiset, this collection is defined by oxymorons