18.5

Example

DOCUMENTATION COMMENTS

public class Object {

/**

 * Returns the Class of this Object. Java has a runtime

 * representation for classes  a descriptor of type Class

 *   which the method getClass() returns for any Object.

 */

public final native Class getClass();

/**

 * Returns a hashcode for this Object.

 * Each Object in the Java system has a hashcode.

 * The hashcode is a number that is usually different

 * for different Objects. It is used when storing Objects

 * in hashtables.

 * Note: hashcodes can be negative as well as positive.

 * @see

java.util.Hashtable

 */

public native int hashCode();

/**

 * Compares two Objects for equality.

 * Returns a boolean that indicates whether this Object

 * is equivalent to the specified Object. This method is

 * used when an Object is stored in a hashtable.

 * @param

obj

the Object to compare with

 * @return

true if these Objects are equal;

 *

false otherwise.

 * @see

java.util.Hashtable

 */

public boolean equals(Object obj) {

return (this == obj);

}

/**

 * Creates a clone of the object. A new instance is

 * allocated and a bitwise clone of the current object

 * is placed in the new object.

 * @return

a clone of this Object.

 * @exception

OutOfMemoryError If there is not enough

 *

memory.

 * @exception

CloneNotSupportedException Object

 *

explicitly does not want to be

 *

cloned, or it does not support

 *

the Cloneable interface.

 */

protected native Object clone()

throws CloneNotSupportedException;

424