hg/stx-libbasic: comparison Collection.st

equal deleted inserted replaced

-:2ca0c225509e
+:d9c9360104ad
 "
 #(1 2 3 4) fourth
 "
 !
+keysSorted
+"return the keys as a sorted sequenceable collection.
+Some collections (which keep their keys already sorted) may
+redefine this method to return the keys as they are kept internally.
+The fallback here sorts them into an OrderedCollection"
+^ self keys asNewOrderedCollection sort
+!
 last
 "return the last element of the collection.
 This should be redefined in subclasses."
 |theLastOne any|
 ^ self asIntegerArray:LongIntegerArray
 !
 asNewArray
-"return a new Array with the receiver collections elements"
+"return a new Array with the receiver collection's elements.
+This method ensures that the returned collection is a new one, not
+the same or shared with the original receiver"
 ^ self asArray
 !
 asNewDictionary
-"return a new Dictionary with the receiver collections elements"
+"return a new Dictionary with the receiver collection's elements.
+This method ensures that the returned collection is a new one, not
+the same or shared with the original receiver"
 ^ self asDictionary
 !
 asNewIdentitySet
-"return a new IdentitySet with the receiver collections elements"
+"return a new IdentitySet with the receiver collection's elements.
+This method ensures that the returned collection is a new one, not
+the same or shared with the original receiver"
 ^ self asIdentitySet
 !
 asNewOrderedCollection
-"return a new OrderedCollection with the receiver collections elements"
+"return a new OrderedCollection with the receiver collection's elements.
+This method ensures that the returned collection is a new one, not
+the same or shared with the original receiver"
 ^ self asOrderedCollection
 !
 asNewOrderedSet
-"return a new OrderedSet with the receiver collections elements"
+"return a new OrderedSet with the receiver collection's elements.
+This method ensures that the returned collection is a new one, not
+the same or shared with the original receiver"
 ^ self asOrderedSet
 !
 asNewSet
-"return a new Set with the receiver collections elements"
+"return a new Set with the receiver collection's elements.
+This method ensures that the returned collection is a new one, not
+the same or shared with the original receiver"
 ^ self asSet
 !
 asNilIfEmpty
 ^ self addAllTo:(OrderedCollection new:self size)
 !
 asOrderedSet
-"return a new OrderedSet with the receiver collections elements"
+"return a new OrderedSet with the receiver collection's elements.
+Notice: this is redefined in OrderedSet, where it returns the receiver.
+Use asNewOrderedSet, if you intent to modify the returned collection."
 ^ self addAllTo:(OrderedSet new:self size)
 !
 asRunArray
 ! !
 !Collection class methodsFor:'documentation'!
 version
-^ '$Header: /cvs/stx/stx/libbasic/Collection.st,v 1.303 2013-06-06 12:11:42 cg Exp $'
+^ '$Header: /cvs/stx/stx/libbasic/Collection.st,v 1.304 2013-06-09 13:03:50 cg Exp $'
 !
 version_CVS
-^ '$Header: /cvs/stx/stx/libbasic/Collection.st,v 1.303 2013-06-06 12:11:42 cg Exp $'
+^ '$Header: /cvs/stx/stx/libbasic/Collection.st,v 1.304 2013-06-09 13:03:50 cg Exp $'
 ! !
 Collection initialize!

changeset 15386	d9c9360104ad
parent 15378	5c82887fc830
child 15408	8fdba8d23307
child 18066	89d51443ba6f