home *** CD-ROM | disk | FTP | other *** search
/ ActiveX Programming Unleashed CD / AXU.iso / jgl_1_1 / src / objectarray.java < prev    next >
Encoding:
Java Source  |  1996-09-10  |  2.5 KB  |  118 lines
  1. // Copyright(c) 1996 ObjectSpace, Inc.
  2. // Portions Copyright(c) 1995, 1996 Hewlett-Packard Company.
  3.  
  4. package jgl;
  5.  
  6. import java.util.Enumeration;
  7.  
  8. /**
  9.  * ObjectArray allows a native array of Objects to be accessed like a Container.
  10.  * It is particularly useful for applying generic algorithms like Sorting.sort()
  11.  * to a native array.
  12.  * <p>
  13.  * @version 1.1
  14.  * @author ObjectSpace, Inc.
  15.  */
  16.  
  17. public class ObjectArray extends ArrayAdapter
  18.   {
  19.   Object myArray[];
  20.  
  21.   public ObjectArray( Object array[] )
  22.     {
  23.     myArray = array;
  24.     }
  25.  
  26.   public ObjectArray( ObjectArray array )
  27.     {
  28.     myArray = array.myArray;
  29.     }
  30.  
  31.   /**
  32.    * Return a shallow copy of myself.
  33.    */
  34.   public Object clone()
  35.     {
  36.     return new ObjectArray( this );
  37.     }
  38.  
  39.   /**
  40.    * Return a string that describes me.
  41.    */
  42.   public String toString()
  43.     {
  44.     return Printing.toString( this, "Object[]" );
  45.     }
  46.  
  47.   /**
  48.    * Return true if I'm equal to a specified object.
  49.    * @param object The object to compare myself against.
  50.    * @return true if I'm equal to the specified object.
  51.    */
  52.   public boolean equals( Object object )
  53.     {
  54.     return Comparing.equal( this, (ObjectArray) object );
  55.     }
  56.   
  57.   /**
  58.    * Return the number of objects that I contain.
  59.    */
  60.   public int size()
  61.     {
  62.     return myArray.length;
  63.     }
  64.  
  65.   /**
  66.    * Return the maximum number of objects that I can contain.
  67.    */
  68.   public int maxSize()
  69.     {
  70.     return myArray.length;
  71.     }
  72.  
  73.   /**
  74.    * Return an Enumeration of my elements.
  75.    */
  76.   public Enumeration elements()
  77.     {
  78.     return ObjectIterator.begin( myArray, this );
  79.     }
  80.  
  81.   /**
  82.    * Return an iterator positioned at my first item.
  83.    */
  84.   public ForwardIterator start()
  85.     {
  86.     return ObjectIterator.begin( myArray, this );
  87.     }
  88.  
  89.   /**
  90.    * Return an iterator positioned immediately after my last item.
  91.    */
  92.   public ForwardIterator finish()
  93.     {
  94.     return ObjectIterator.end( myArray, this );
  95.     }
  96.  
  97.   /**
  98.    * Return the object at the specified index.
  99.    * @param index The index.
  100.    */
  101.   public Object at( int index )
  102.     {
  103.     return myArray[index];
  104.     }
  105.  
  106.   /**
  107.    * Set the object at a specified index.  The object must be a Integer
  108.    * @param index The index.
  109.    * @param object The object to place at the specified index.
  110.    * @exception java.lang.IndexOutOfBoundsException if index is not in range.
  111.    */
  112.   public void put( int index, Object object )
  113.     {
  114.     myArray[index] = object;
  115.     }
  116.   }
  117.  
  118.