Tak mi to nedalo a koukl jsem se na javadoc. K JDK 5:

Returns true if this set contains the specified element.

a k JDK 6:

Returns true if this set contains the specified element. More formally, returns 
true if and only if this set contains an
element e such that (o==null ? e==null : o.equals(e)).

Rekl bych ze formulace je diky "if and olny if" skutecne zavadejici. Ale jak 
bych rekl jiz po Xte, zdrojak hovori jasnou
reci!

Jirka

Jozef Babjak napsal(a):
>> Mo�n� se moje odpov�� nebude n�komu l�bit, ale podle mne v javadoc chyba
>> nen�. Toto chov�n� vypl�v� z vlastnost� he�ov�ch tabulek a m�la by to proto
>> vysv�tlit u�ebnice (nebo lektor) jako obecnou vlastnost v�ech objekt�
>> vyu��vaj�c�ch he�ov�ch tabulek. Jestli k v�m takov�to informace je�t�
>> nepronikla, sp�lejte sv�m u�itel�m a autor�m u�ebnic, z nich� jste se Javu
>> u�ili.
>>
>> Rozli�ujte javadoc a u�ebnici. Kdyby se m�ly d�vat do javadoc i takov�to
>> v�ci, tak tam za chv�li n�kdo bude cht�t vysv�tlit, jak funguje interface
>> nebo jin� jazykov� konstrukt. Pro javadoc by m�lo sta�it prohl�en�, �e dan�
>> kontejner je definov�n pomoc� he�ov�ch tabulek, a to tam je.
>>
>> T�m nechci ��st, �e by javadoc n�jakou drobnou zm�nku na toto t�ma nesnesl,
>> ale ch�pu, pro� se Sun�m nechce do n�j d�vat v�ci, kter� maj� b�t prim�rn�
>> vysv�tleny jinde. J� bych jim sp� vy��tal, �e tuto informaci nedali do
>> tutori�lu (leda bych ji tam ve sv� slepot� nena�el) - tam podle mne pat��.
>> J� bych tam za�adil kapitolku o he�ov�ch tabulk�ch, na kterou by se pak
>> odvol�valy v�echny kapitoly pojedn�vaj�c�ch o kontejnerech, kter� jsou na
>> he�ov�ch tabulk�ch zalo�eny.
> 
>   ^-- To by bolo vsetko pekene, keby sa javadoc uspokojil so
> vseobecnym tvrdenim, ze contains() vracia true, ak sa objekt
> v mnozine nachadza; v tom pripade je na javadoc-u triedy HashSet
> oznamit ze ako backend pouziva HashMap a ze treba vziat na zretel
> z toho plynuce konsekvencie (co javadoc triedy HashSet robi), ked
> hned aj "z toho plynuce konsekvencie" maju byt priemernemu programatorovi
> zname. Zasadna chyba je, ze javadoc triedy contains() ODHALUJE 
> IMPLEMENTACIU, zial taku, ktoru samotna metoda neimplementuje. 
> 
> Javadoc metody contains() v triede HashSet JE chybny.
> 
> J. 
> 

-- 
Jiří Mareš (mailto:[EMAIL PROTECTED])
ČSAD SVT Praha, s.r.o. (http://www.svt.cz)
Czech Republic

Odpovedet emailem