Program Base Library Functions

int pblArrayListEquals

( pblArrayList* arrayList,
  void* object )

Compares the specified object with this list for equality.

Documentation

Compares the specified object with this list for equality.

Returns true if and only if the specified object is also a list, both lists have the same size, and all corresponding pairs of elements in the two lists are equal. (Two elements e1 and e2 are equal if (e1==null ? e2==null : e1.equals(e2)).)

In other words, two lists are defined to be equal if they contain the same elements in the same order.

This implementation first checks if the specified object is this list. If so, it returns true; if not, it checks if the specified object is a list. If not, it returns false; if so, it iterates over both lists, comparing corresponding pairs of elements. If any comparison returns false, this method returns false. If either iterator runs out of elements before the other it returns false (as the lists are of unequal length); otherwise it returns true when the iterations complete.

Parameters:
arrayList - The list to use
object - The object to be compared for equality with this list.
Returns:
int rc > 0: The specified object is equal to this list.
int rc == 0: The specified object is not equal to this list.
int rc < 0: An error, see pbl_errno PBL_ERROR_OUT_OF_MEMORY - out of memory

Alphabetic index



This page was generated with the help of DOC++.