Assoc.st
author claus
Mon, 08 May 1995 05:31:14 +0200
changeset 339 e8658d38abfb
parent 154 d4236ec280a6
child 379 5b5a130ccd09
permissions -rw-r--r--
.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
     1
"
5
67342904af11 *** empty log message ***
claus
parents: 3
diff changeset
     2
 COPYRIGHT (c) 1989 by Claus Gittinger
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
     3
              All Rights Reserved
a27a279701f8 Initial revision
claus
parents:
diff changeset
     4
a27a279701f8 Initial revision
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
a27a279701f8 Initial revision
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
a27a279701f8 Initial revision
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
a27a279701f8 Initial revision
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
a27a279701f8 Initial revision
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
a27a279701f8 Initial revision
claus
parents:
diff changeset
    10
 hereby transferred.
a27a279701f8 Initial revision
claus
parents:
diff changeset
    11
"
a27a279701f8 Initial revision
claus
parents:
diff changeset
    12
154
d4236ec280a6 *** empty log message ***
claus
parents: 92
diff changeset
    13
LookupKey subclass:#Association
d4236ec280a6 *** empty log message ***
claus
parents: 92
diff changeset
    14
       instanceVariableNames:'value'
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    15
       classVariableNames:''
a27a279701f8 Initial revision
claus
parents:
diff changeset
    16
       poolDictionaries:''
a27a279701f8 Initial revision
claus
parents:
diff changeset
    17
       category:'Collections-Support'
a27a279701f8 Initial revision
claus
parents:
diff changeset
    18
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    19
a27a279701f8 Initial revision
claus
parents:
diff changeset
    20
Association comment:'
5
67342904af11 *** empty log message ***
claus
parents: 3
diff changeset
    21
COPYRIGHT (c) 1989 by Claus Gittinger
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    22
              All Rights Reserved
92
0c73b48551ac *** empty log message ***
claus
parents: 82
diff changeset
    23
154
d4236ec280a6 *** empty log message ***
claus
parents: 92
diff changeset
    24
$Header: /cvs/stx/stx/libbasic/Attic/Assoc.st,v 1.10 1994-10-10 00:19:42 claus Exp $
68
59faa75185ba *** empty log message ***
claus
parents: 54
diff changeset
    25
'!
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    26
68
59faa75185ba *** empty log message ***
claus
parents: 54
diff changeset
    27
!Association class methodsFor:'documentation'!
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    28
82
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    29
copyright
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    30
"
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    31
 COPYRIGHT (c) 1989 by Claus Gittinger
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    32
              All Rights Reserved
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    33
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    34
 This software is furnished under a license and may be used
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    35
 only in accordance with the terms of that license and with the
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    36
 inclusion of the above copyright notice.   This software may not
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    37
 be provided or otherwise made available to, or used by, any
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    38
 other person.  No title to or ownership of the software is
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    39
 hereby transferred.
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    40
"
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    41
!
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    42
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    43
version
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    44
"
154
d4236ec280a6 *** empty log message ***
claus
parents: 92
diff changeset
    45
$Header: /cvs/stx/stx/libbasic/Attic/Assoc.st,v 1.10 1994-10-10 00:19:42 claus Exp $
82
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    46
"
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    47
!
0147b4f725ae *** empty log message ***
claus
parents: 68
diff changeset
    48
68
59faa75185ba *** empty log message ***
claus
parents: 54
diff changeset
    49
documentation
59faa75185ba *** empty log message ***
claus
parents: 54
diff changeset
    50
"
92
0c73b48551ac *** empty log message ***
claus
parents: 82
diff changeset
    51
    Associations are a key-value pair; conceptionally, they are the elements of 
0c73b48551ac *** empty log message ***
claus
parents: 82
diff changeset
    52
    Dictionaries - storing value under the key. (However, the real implementation
0c73b48551ac *** empty log message ***
claus
parents: 82
diff changeset
    53
    of Dictionary is different).
154
d4236ec280a6 *** empty log message ***
claus
parents: 92
diff changeset
    54
    Taken by itself, an association is not very useful.
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    55
68
59faa75185ba *** empty log message ***
claus
parents: 54
diff changeset
    56
    Instance variables:
59faa75185ba *** empty log message ***
claus
parents: 54
diff changeset
    57
154
d4236ec280a6 *** empty log message ***
claus
parents: 92
diff changeset
    58
        key             <Object>        the key (inherited)
68
59faa75185ba *** empty log message ***
claus
parents: 54
diff changeset
    59
        value           <Object>        the value
59faa75185ba *** empty log message ***
claus
parents: 54
diff changeset
    60
"
59faa75185ba *** empty log message ***
claus
parents: 54
diff changeset
    61
! !
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    62
a27a279701f8 Initial revision
claus
parents:
diff changeset
    63
!Association class methodsFor:'instance creation'!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    64
a27a279701f8 Initial revision
claus
parents:
diff changeset
    65
key:aKey value:aValue
a27a279701f8 Initial revision
claus
parents:
diff changeset
    66
    "return a new Association"
a27a279701f8 Initial revision
claus
parents:
diff changeset
    67
a27a279701f8 Initial revision
claus
parents:
diff changeset
    68
    ^ self basicNew key:aKey value:aValue
a27a279701f8 Initial revision
claus
parents:
diff changeset
    69
! !
a27a279701f8 Initial revision
claus
parents:
diff changeset
    70
a27a279701f8 Initial revision
claus
parents:
diff changeset
    71
!Association methodsFor:'accessing'!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    72
a27a279701f8 Initial revision
claus
parents:
diff changeset
    73
value
a27a279701f8 Initial revision
claus
parents:
diff changeset
    74
    "return the value of the association"
a27a279701f8 Initial revision
claus
parents:
diff changeset
    75
a27a279701f8 Initial revision
claus
parents:
diff changeset
    76
    ^ value
a27a279701f8 Initial revision
claus
parents:
diff changeset
    77
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    78
a27a279701f8 Initial revision
claus
parents:
diff changeset
    79
value:anObject
a27a279701f8 Initial revision
claus
parents:
diff changeset
    80
    "set the value of the receiver to be anObject.
a27a279701f8 Initial revision
claus
parents:
diff changeset
    81
     Return the receiver"
a27a279701f8 Initial revision
claus
parents:
diff changeset
    82
a27a279701f8 Initial revision
claus
parents:
diff changeset
    83
    value := anObject
a27a279701f8 Initial revision
claus
parents:
diff changeset
    84
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    85
a27a279701f8 Initial revision
claus
parents:
diff changeset
    86
key:aKey value:aValue
a27a279701f8 Initial revision
claus
parents:
diff changeset
    87
    "set both the key and value of the receiver.
a27a279701f8 Initial revision
claus
parents:
diff changeset
    88
     Return the receiver"
a27a279701f8 Initial revision
claus
parents:
diff changeset
    89
a27a279701f8 Initial revision
claus
parents:
diff changeset
    90
    key := aKey.
a27a279701f8 Initial revision
claus
parents:
diff changeset
    91
    value := aValue
a27a279701f8 Initial revision
claus
parents:
diff changeset
    92
! !
a27a279701f8 Initial revision
claus
parents:
diff changeset
    93
a27a279701f8 Initial revision
claus
parents:
diff changeset
    94
!Association methodsFor:'comparing'!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    95
a27a279701f8 Initial revision
claus
parents:
diff changeset
    96
= anAssociation
68
59faa75185ba *** empty log message ***
claus
parents: 54
diff changeset
    97
    "return true if the receiver equals the argument.
154
d4236ec280a6 *** empty log message ***
claus
parents: 92
diff changeset
    98
     Notice, that this compares both key AND value.
d4236ec280a6 *** empty log message ***
claus
parents: 92
diff changeset
    99
     Time will show if this is ok."
43
00ca34676cbf *** empty log message ***
claus
parents: 5
diff changeset
   100
154
d4236ec280a6 *** empty log message ***
claus
parents: 92
diff changeset
   101
    self species == anAssociation species ifTrue:[
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   102
        (anAssociation key = key) ifTrue:[
a27a279701f8 Initial revision
claus
parents:
diff changeset
   103
            ^ anAssociation value = value
a27a279701f8 Initial revision
claus
parents:
diff changeset
   104
        ]
a27a279701f8 Initial revision
claus
parents:
diff changeset
   105
    ].
a27a279701f8 Initial revision
claus
parents:
diff changeset
   106
    ^ false
54
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   107
!
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   108
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   109
hash
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   110
    "return an integer useful for hashing on the receiver;
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   111
     redefined since = is redefined here."
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   112
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   113
    ^ (key hash) bitXor:(value hash)
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   114
! !
a27a279701f8 Initial revision
claus
parents:
diff changeset
   115
a27a279701f8 Initial revision
claus
parents:
diff changeset
   116
!Association methodsFor:'printing & storing'!
a27a279701f8 Initial revision
claus
parents:
diff changeset
   117
54
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   118
printOn:aStream
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   119
    "return a string containing a printable representation
a27a279701f8 Initial revision
claus
parents:
diff changeset
   120
     of the receiver"
a27a279701f8 Initial revision
claus
parents:
diff changeset
   121
54
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   122
    key printOn:aStream.
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   123
    aStream nextPutAll:'->'.
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   124
    value printOn:aStream
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   125
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
   126
a27a279701f8 Initial revision
claus
parents:
diff changeset
   127
displayString
a27a279701f8 Initial revision
claus
parents:
diff changeset
   128
    "return a string containing a printable representation
54
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   129
     of the receiver for displaying - redefined to use display string on
06dbdeeed4f9 *** empty log message ***
claus
parents: 43
diff changeset
   130
     the components for nicer look"
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   131
a27a279701f8 Initial revision
claus
parents:
diff changeset
   132
    ^ key displayString , '->' , value displayString
a27a279701f8 Initial revision
claus
parents:
diff changeset
   133
! !