eXept Software AG Logo

Smalltalk/X Webserver

Documentation of class 'TreeSet':

Home

Documentation
www.exept.de
Everywhere
for:
[back]

Class: TreeSet


Inheritance:

   Object
   |
   +--Collection
      |
      +--TreeSet

Package:
stx:libbasic2
Category:
Collections-Ordered-Trees
Version:
rev: 1.7 date: 2017/01/20 18:52:31
user: stefan
file: TreeSet.st directory: libbasic2
module: stx stc-classLibrary: libbasic2
Author:
Avi Bryant

Description:


BTree and TSTree

A bunch of collection classes that are useful for building large indices of things.
It's especially geared towards people using OODBs like GOODS, but can be used it in the image too:
the BTree class is great for when you need to select numeric keys by range,
and TSTree makes a solid basis for full-text search.
TreeSet has an interesting optimized #intersection: that lets you compare two collections without
looking at every item of either.
I'm also going to be rolling some code in here from Benjamin Pollack specifically aimed at indexing
by date ranges, which lets you do quick queries of all the events that overlap with a specific week,
for instance.


[license:]
    Dual licensed under both SqueakL and MIT.
    This enables both base Squeak inclusion and 100% reuse.


Class protocol:

instance creation
o  keys: aBtreeKeys sortSelector: aSymbol

o  new

o  sortBy: aSymbol


Instance protocol:

initialize-release
o  initializeWithKeys: aBtreeKeys sortSelector: aSymbol

plugs
o  keyForValue: anObject

o  value: anObject matches: otherObject

private
o  bucket: anArray includes: anObject

o  tree

public
o  add: anObject

o  do: aBlock

o  includes: anObject

o  intersect: aCollection
(comment from inherited method)
return a new set containing all elements of the receiver,
which are also contained in the argument collection.
For large collections you better use a Set for aCollection

o  remove: anObject
remove all occurrences of anObject
Warning:
This is inconsistent with the inherited collection>>remove:,
which only remove the first occurrence.
Should this be fixed?

o  sortSelector

testing
o  isFixedSize
return true if the receiver cannot grow



ST/X 7.2.0.0; WebServer 1.670 at bd0aa1f87cdd.unknown:8081; Fri, 14 May 2021 16:59:04 GMT