[jira] [Reopened] (COLLECTIONS-749) Better documentation needed for HashFunctionIdentity.Signedness

["Alex Herbert (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/COLLECTIONS-749?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Alex Herbert reopened COLLECTIONS-749:
--------------------------------------

> Better documentation needed for HashFunctionIdentity.Signedness
> ---------------------------------------------------------------
>
>                 Key: COLLECTIONS-749
>                 URL: https://issues.apache.org/jira/browse/COLLECTIONS-749
>             Project: Commons Collections
>          Issue Type: Improvement
>          Components: Collection
>    Affects Versions: 4.5
>            Reporter: Claude Warren
>            Priority: Minor
>             Fix For: 4.5
>
>          Time Spent: 20m
>  Remaining Estimate: 0h
>
> From Alex Herbert:
> HashFunctionIdentity.Signedness
>  
>  This is not fully documented as to what the sign applies to. There is no 
>  javadoc on the enum values for SIGNED and UNSIGNED. The current javadoc 
>  states "Identifies the signedness of the calculations for this function".
>  
>  I assume this applies to the Hash computation in 'long 
>  HashFunction.apply(byte[], int)'
>  
>  Does this mean the hash algorithm has a variant that can treat the 
>  bytes/seed as signed or unsigned. If so which one because 2 enum values 
>  cannot cover all 4 possibilities. Since there is no javadoc it is 
>  unclear exactly what this property is supposed to indicate.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)