[Oorexx-rfes] [ oorexx-Feature Requests-1733078 ] Please add a clarification to the '==' method in 'Object'

[SourceForge.net <no...@so...>]

Feature Requests item #1733078, was opened at 2007-06-07 17:23
Message generated for change (Comment added) made by bigrixx
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=684733&aid=1733078&group_id=119701

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation
Group: Next Release
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Rony G. Flatscher (orexx)
Assigned to: David Ashley (wdashley)
Summary: Please add a clarification to the '==' method in 'Object'

Initial Comment:
The current documentation for the Object's "==" method without an argument states (e.g. <http://www.oorexx.org/rexxref/x9980.htm#COO>):

"Returns 1 (true) or 0 (false), the result of performing a specified comparison operation. If you specify the == operator and omit argument, a string representation is returned representing a hash value for Set, Bag, Table, Relation, and Directory."

Suggested addition at the end of this paragraph to clarify that that hash value cannot be used to determine the identity of an object: 

---------- cut here ---------
Please note: different objects may generate the same hash value occasionally, therefore this value cannot be regarded to be a "unique identifier".
---------- cut here ---------


----------------------------------------------------------------------

>Comment By: Rick McGuire (bigrixx)
Date: 2007-06-07 17:30

Message:
Logged In: YES 
user_id=1125291
Originator: NO

I strongly disagree with this wording.  Different objects will generate
the same hash value more than just "occasionally".  It is frequently a
requirement that they generate the same has value.  Consider the following
sequence:

  a = "abc"  
  b = "ab"||"c"

the variables "A" and "B" point to different instances of the string
class, each with the internal value "abc".  These two instances must return
the same value for their hashes otherwise hash table lookups using these
two strings would not succeed.  



----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=684733&aid=1733078&group_id=119701