com.esri.arcgis.system
Class Set

java.lang.Object
  com.esri.arcgis.system.Set

All Implemented Interfaces:

ISet, java.io.Serializable

public class Set

extends java.lang.Object

implements ISet

Generic set of objects.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Description

The Set object is used to hold a collection of objects, which do not have to be homogenous. Like the similar Array object, the Set object enables ArcObjects to pass around collections of object references in a cross platform manner; you can store and retrieve a set of object references in the same way regardless of which ArcObjects API you are using.

The Set object offers only sequential access to its members rather than the random access of an Array. It does, however, provide a method to search the set for a particular object. The most important difference between an Array object and a Set object, is that an object reference can only belong to a Set once. If you add the same object to a Set twice, no error occurs but the resulting Set has only one reference to the object. A Set is analogous to a mathematical concept of a set—there is no guaranteed order to its members. The Set object is somewhat slower than an Array for storing references to large amounts of objects. Set objects are used by several interfaces including IRelationshipClass, IFeatureEdit, and IComPropertyPage.

See Also:

Serialized Form

Constructor Summary

Set()
Constructs a Set using ArcGIS Engine.

Set(java.lang.Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.

Method Summary

void	add(java.lang.Object unk) Adds an object to the set.
boolean	equals(java.lang.Object o) Compare this object with another
boolean	find(java.lang.Object unk) Searches for the object in the set.
ISet	getAsISet() Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
static java.lang.String	getClsid()
int	getCount() The element count of the set.
int	hashCode() the hashcode for this object
java.lang.Object	next() Returns the next object in the set.
void	remove(java.lang.Object unk) Removes the object from the set.
void	removeAll() Removes all objects from the set.
void	reset() Resets the set for enumerating through the objects with Next.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Set

public Set()
    throws java.io.IOException,
           java.net.UnknownHostException

Constructs a Set using ArcGIS Engine.

Throws:

java.io.IOException - if there are interop problems

java.net.UnknownHostException - if there are interop problems

Set

public Set(java.lang.Object obj)
    throws java.io.IOException

Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.

Construct a Set using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to Set.
Set theSet = (Set) obj;

Parameters:

obj - an object returned from ArcGIS Engine or Server

Throws:

java.io.IOException - if there are interop problems

Method Detail

getClsid

public static java.lang.String getClsid()

getAsISet

public ISet getAsISet()

Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.

equals

public boolean equals(java.lang.Object o)

Compare this object with another

hashCode

public int hashCode()

the hashcode for this object

add

public void add(java.lang.Object unk)
         throws java.io.IOException,
                AutomationException

Description copied from interface: ISet

Adds an object to the set.

Supported Platforms

Windows, Solaris, Linux

Description

Adds the specified object to the Set. If you add the same object to a Set twice, no error occurs but the resulting Set has only one reference to the object.

Remarks

The order in which objects are added to the Set using Add is not guaranteed to be the same order in which they are returned by the Next method.

When adding an object to a Set, you are merely adding a new reference to the object not copying it. The reference is released when the Set is destroyed or the object is removed. For example, if you add geodatabase features to a Set (or an Array) using a feature cursor, you must use a non-recycling cursor, otherwise the memory location of the previous feature is overwritten.

Specified by:

add in interface ISet

Parameters:

unk - A reference to another Object (IUnknown) (in)

Throws:

AutomationException - If the ArcObject component throws an exception.

java.io.IOException - If there are interop problems.

remove

public void remove(java.lang.Object unk)
            throws java.io.IOException,
                   AutomationException

Description copied from interface: ISet

Removes the object from the set.

Supported Platforms

Windows, Solaris, Linux

Description

Removes the reference to the specified object from the Set.

Specified by:

remove in interface ISet

Parameters:

unk - A reference to another Object (IUnknown) (in)

Throws:

AutomationException - If the ArcObject component throws an exception.

java.io.IOException - If there are interop problems.

removeAll

public void removeAll()
               throws java.io.IOException,
                      AutomationException

Description copied from interface: ISet

Removes all objects from the set.

Supported Platforms

Windows, Solaris, Linux

Description

Removes all references to objects from the Set.

Specified by:

removeAll in interface ISet

Throws:

AutomationException - If the ArcObject component throws an exception.

java.io.IOException - If there are interop problems.

find

public boolean find(java.lang.Object unk)
             throws java.io.IOException,
                    AutomationException

Description copied from interface: ISet

Searches for the object in the set.

Supported Platforms

Windows, Solaris, Linux

Description

Indicates whether a reference to the specified object has been added to the Set with the Add method.

Specified by:

find in interface ISet

Parameters:

unk - A reference to another Object (IUnknown) (in)

Returns:

The found

Throws:

AutomationException - If the ArcObject component throws an exception.

java.io.IOException - If there are interop problems.

next

public java.lang.Object next()
                      throws java.io.IOException,
                             AutomationException

Description copied from interface: ISet

Returns the next object in the set.

Supported Platforms

Windows, Solaris, Linux

Description

The Next method returns the next object in the Set.

Remarks

The order that objects are returned from the Set object using the Next method is not guaranteed to be the same order as they were passed into the Add method. However, the Next method will return the objects in the same order.

Specified by:

next in interface ISet

Returns:

A reference to another Object (IUnknown)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

reset

public void reset()
           throws java.io.IOException,
                  AutomationException

Description copied from interface: ISet

Resets the set for enumerating through the objects with Next.

Supported Platforms

Windows, Solaris, Linux

Description

The Reset method resets the Set so that the next call to the Next method returns the first object in the Set.

Remarks

The order that objects are returned from the Set object using the Next method is not guaranteed to be the same order as they were passed into the Add method. However, the Next method will return the objects in the same order.

Specified by:

reset in interface ISet

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getCount

public int getCount()
             throws java.io.IOException,
                    AutomationException

Description copied from interface: ISet

The element count of the set.

Supported Platforms

Windows, Solaris, Linux

Description

Returns the number of objects in the Set.

Specified by:

getCount in interface ISet

Returns:

The count

Throws:

AutomationException - If the ArcObject component throws an exception.

java.io.IOException - If there are interop problems.