WeakIdentityDictionary.st
author Claus Gittinger <cg@exept.de>
Fri, 19 Apr 1996 12:56:05 +0200
changeset 1223 09d16bc18493
parent 1054 62ce964f1d2e
child 1256 249fd57abee5
permissions -rw-r--r--
at:put: returns its arg
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
6
62211a9bc04d Initial revision
claus
parents:
diff changeset
     1
"
62211a9bc04d Initial revision
claus
parents:
diff changeset
     2
 COPYRIGHT (c) 1992 by Claus Gittinger
358
claus
parents: 159
diff changeset
     3
	      All Rights Reserved
6
62211a9bc04d Initial revision
claus
parents:
diff changeset
     4
62211a9bc04d Initial revision
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
62211a9bc04d Initial revision
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
62211a9bc04d Initial revision
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
62211a9bc04d Initial revision
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
62211a9bc04d Initial revision
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
62211a9bc04d Initial revision
claus
parents:
diff changeset
    10
 hereby transferred.
62211a9bc04d Initial revision
claus
parents:
diff changeset
    11
"
62211a9bc04d Initial revision
claus
parents:
diff changeset
    12
62211a9bc04d Initial revision
claus
parents:
diff changeset
    13
IdentityDictionary subclass:#WeakIdentityDictionary
1054
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    14
	instanceVariableNames:''
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    15
	classVariableNames:''
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    16
	poolDictionaries:''
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    17
	category:'Collections-Unordered'
6
62211a9bc04d Initial revision
claus
parents:
diff changeset
    18
!
62211a9bc04d Initial revision
claus
parents:
diff changeset
    19
10
claus
parents: 6
diff changeset
    20
!WeakIdentityDictionary class methodsFor:'documentation'!
claus
parents: 6
diff changeset
    21
88
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    22
copyright
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    23
"
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    24
 COPYRIGHT (c) 1992 by Claus Gittinger
358
claus
parents: 159
diff changeset
    25
	      All Rights Reserved
88
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    26
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    27
 This software is furnished under a license and may be used
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    28
 only in accordance with the terms of that license and with the
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    29
 inclusion of the above copyright notice.   This software may not
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    30
 be provided or otherwise made available to, or used by, any
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    31
 other person.  No title to or ownership of the software is
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    32
 hereby transferred.
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    33
"
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    34
!
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    35
10
claus
parents: 6
diff changeset
    36
documentation
claus
parents: 6
diff changeset
    37
"
88
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    38
    this is a special class to support keeping track of dependents without
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    39
    keeping the values alive - values simply become nil when no one else
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    40
    references it. The original dependency mechanism used a regular Dictionary,
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    41
    which usually leads to a lot of garbage being kept due to a forgotten
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    42
    release. Using a WeakDictionary may be incompatible to ST-80 but is much
81dacba7a63a *** empty log message ***
claus
parents: 63
diff changeset
    43
    more comfortable, since no manual release of dependents is needed.
10
claus
parents: 6
diff changeset
    44
"
claus
parents: 6
diff changeset
    45
! !
claus
parents: 6
diff changeset
    46
359
claus
parents: 358
diff changeset
    47
!WeakIdentityDictionary methodsFor:'adding & removing'!
claus
parents: 358
diff changeset
    48
claus
parents: 358
diff changeset
    49
at:key put:value
claus
parents: 358
diff changeset
    50
    |wasBlocked|
claus
parents: 358
diff changeset
    51
claus
parents: 358
diff changeset
    52
    wasBlocked := OperatingSystem blockInterrupts.
claus
parents: 358
diff changeset
    53
    super at:key put:value.
1223
09d16bc18493 at:put: returns its arg
Claus Gittinger <cg@exept.de>
parents: 1054
diff changeset
    54
    wasBlocked ifFalse:[OperatingSystem unblockInterrupts].
09d16bc18493 at:put: returns its arg
Claus Gittinger <cg@exept.de>
parents: 1054
diff changeset
    55
    ^ value
09d16bc18493 at:put: returns its arg
Claus Gittinger <cg@exept.de>
parents: 1054
diff changeset
    56
09d16bc18493 at:put: returns its arg
Claus Gittinger <cg@exept.de>
parents: 1054
diff changeset
    57
    "Modified: 19.4.1996 / 11:40:42 / cg"
359
claus
parents: 358
diff changeset
    58
!
claus
parents: 358
diff changeset
    59
claus
parents: 358
diff changeset
    60
removeKey:aKey ifAbsent:aBlock
1054
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    61
    "redefined to avoid synchronization problems, in case
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    62
     of interrupts 
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    63
     (otherwise, there could be some other operation on the receiver
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    64
       done by another process, which garbles my contents)"
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    65
359
claus
parents: 358
diff changeset
    66
    |wasBlocked|
claus
parents: 358
diff changeset
    67
claus
parents: 358
diff changeset
    68
    wasBlocked := OperatingSystem blockInterrupts.
claus
parents: 358
diff changeset
    69
    [
1054
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    70
        super removeKey:aKey ifAbsent:aBlock
359
claus
parents: 358
diff changeset
    71
    ] valueNowOrOnUnwindDo:[
1054
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    72
        wasBlocked ifFalse:[OperatingSystem unblockInterrupts]
359
claus
parents: 358
diff changeset
    73
    ]
1054
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    74
62ce964f1d2e commentary
Claus Gittinger <cg@exept.de>
parents: 635
diff changeset
    75
    "Modified: 1.3.1996 / 21:16:29 / cg"
359
claus
parents: 358
diff changeset
    76
! !
claus
parents: 358
diff changeset
    77
10
claus
parents: 6
diff changeset
    78
!WeakIdentityDictionary methodsFor:'element disposal'!
claus
parents: 6
diff changeset
    79
claus
parents: 6
diff changeset
    80
informDispose
claus
parents: 6
diff changeset
    81
    "an element (either key or value) died - rehash"
6
62211a9bc04d Initial revision
claus
parents:
diff changeset
    82
10
claus
parents: 6
diff changeset
    83
    | sz "{ Class:SmallInteger }" 
358
claus
parents: 159
diff changeset
    84
      any wasBlocked |
claus
parents: 159
diff changeset
    85
claus
parents: 159
diff changeset
    86
    "
claus
parents: 159
diff changeset
    87
     have to block here - dispose may be done at a low priority
claus
parents: 159
diff changeset
    88
     from the background finalizer. If new views are opened in
claus
parents: 159
diff changeset
    89
     the foreground, the dependency dictionary may get corrupted
claus
parents: 159
diff changeset
    90
     otherwise
claus
parents: 159
diff changeset
    91
    "
claus
parents: 159
diff changeset
    92
    wasBlocked := OperatingSystem blockInterrupts.
10
claus
parents: 6
diff changeset
    93
claus
parents: 6
diff changeset
    94
    sz := keyArray size.
claus
parents: 6
diff changeset
    95
    any := false.
claus
parents: 6
diff changeset
    96
    1 to:sz do:[:index |
358
claus
parents: 159
diff changeset
    97
	(keyArray at:index) isNil ifTrue:[
claus
parents: 159
diff changeset
    98
	   (valueArray at:index) notNil ifTrue:[
95
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
    99
"/ soon to come; can then avoid rehash
359
claus
parents: 358
diff changeset
   100
"/                "
claus
parents: 358
diff changeset
   101
"/                 if the next slot is not nil, it could be there due
claus
parents: 358
diff changeset
   102
"/                 to a hash collision. In this case we have to put a 
claus
parents: 358
diff changeset
   103
"/                 DeletedMark into the slot.
claus
parents: 358
diff changeset
   104
"/                "
95
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   105
"/
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   106
"/                index == sz ifTrue:[
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   107
"/                    next := 1
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   108
"/                ] ifFalse:[
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   109
"/                    next := index + 1.
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   110
"/                ].
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   111
"/
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   112
"/                (keyArray basicAt:next) notNil ifTrue:[
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   113
"/                    (valueArray basicAt:next) notNil ifTrue:[
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   114
"/                        keyArray basicAt:index put:DeletedEntry
358
claus
parents: 159
diff changeset
   115
"/                  ]
95
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   116
"/                ].
d22739a0c6e9 *** empty log message ***
claus
parents: 88
diff changeset
   117
358
claus
parents: 159
diff changeset
   118
		valueArray at:index put:nil.
claus
parents: 159
diff changeset
   119
		tally := tally - 1.
claus
parents: 159
diff changeset
   120
		any := true
claus
parents: 159
diff changeset
   121
	    ]
claus
parents: 159
diff changeset
   122
	]
10
claus
parents: 6
diff changeset
   123
    ].
358
claus
parents: 159
diff changeset
   124
    any ifTrue:[self rehash].
claus
parents: 159
diff changeset
   125
359
claus
parents: 358
diff changeset
   126
    wasBlocked ifFalse:[OperatingSystem unblockInterrupts].
6
62211a9bc04d Initial revision
claus
parents:
diff changeset
   127
! !
609
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   128
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   129
!WeakIdentityDictionary methodsFor:'private'!
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   130
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   131
keyContainerOfSize:n
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   132
    "return a container for keys of size n.
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   133
     use WeakArrays here."
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   134
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   135
    |w|
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   136
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   137
    w := WeakArray new:n.
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   138
    w watcher:self.
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   139
    ^ w
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   140
! !
12be97f6d5a7 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   141
635
86cbe76f5a20 version at the end
Claus Gittinger <cg@exept.de>
parents: 609
diff changeset
   142
!WeakIdentityDictionary class methodsFor:'documentation'!
86cbe76f5a20 version at the end
Claus Gittinger <cg@exept.de>
parents: 609
diff changeset
   143
86cbe76f5a20 version at the end
Claus Gittinger <cg@exept.de>
parents: 609
diff changeset
   144
version
1223
09d16bc18493 at:put: returns its arg
Claus Gittinger <cg@exept.de>
parents: 1054
diff changeset
   145
    ^ '$Header: /cvs/stx/stx/libbasic/WeakIdentityDictionary.st,v 1.15 1996-04-19 10:56:05 cg Exp $'
635
86cbe76f5a20 version at the end
Claus Gittinger <cg@exept.de>
parents: 609
diff changeset
   146
! !