Boolean.st
author Claus Gittinger <cg@exept.de>
Sun, 02 Nov 1997 20:14:50 +0100
changeset 3089 0823aa17ac4d
parent 3070 1bf5a29fddc9
child 4656 aa895a9835a2
permissions -rw-r--r--
checkin from browser
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) 1988 by Claus Gittinger
159
514c749165c3 *** empty log message ***
claus
parents: 92
diff changeset
     3
	      All Rights Reserved
1
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
a27a279701f8 Initial revision
claus
parents:
diff changeset
    13
Object subclass:#Boolean
1245
c8afea3d5af0 commentary
Claus Gittinger <cg@exept.de>
parents: 1119
diff changeset
    14
	instanceVariableNames:''
c8afea3d5af0 commentary
Claus Gittinger <cg@exept.de>
parents: 1119
diff changeset
    15
	classVariableNames:''
c8afea3d5af0 commentary
Claus Gittinger <cg@exept.de>
parents: 1119
diff changeset
    16
	poolDictionaries:''
c8afea3d5af0 commentary
Claus Gittinger <cg@exept.de>
parents: 1119
diff changeset
    17
	category:'Kernel-Objects'
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    18
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    19
88
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    20
!Boolean class methodsFor:'documentation'!
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    21
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    22
copyright
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    23
"
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    24
 COPYRIGHT (c) 1988 by Claus Gittinger
159
514c749165c3 *** empty log message ***
claus
parents: 92
diff changeset
    25
	      All Rights Reserved
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    26
88
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    27
 This software is furnished under a license and may be used
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    28
 only in accordance with the terms of that license and with the
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    29
 inclusion of the above copyright notice.   This software may not
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    30
 be provided or otherwise made available to, or used by, any
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    31
 other person.  No title to or ownership of the software is
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    32
 hereby transferred.
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    33
"
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    34
!
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    35
88
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    36
documentation
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    37
"
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    38
    Boolean is an abstract class defining the common protocol for logical
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    39
    values. The logical values are represented by its two subclasses True and False.
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    40
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    41
    There are no instances of Boolean in the system and there is only one
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    42
    instance of True (which is the global true) and one of False (false).
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    43
88
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    44
    Boolean redefines some messages which deal with copying Booleans,
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    45
    to make certain there is only one instance of each.
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    46
    The system will behave strange if you fiddle around here and create
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    47
    new instances of True or False (i.e. it will not recognize these new
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    48
    instances as being true or false).
1294
e26bbb61f6b2 documentation
Claus Gittinger <cg@exept.de>
parents: 1266
diff changeset
    49
e26bbb61f6b2 documentation
Claus Gittinger <cg@exept.de>
parents: 1266
diff changeset
    50
    [author:]
e26bbb61f6b2 documentation
Claus Gittinger <cg@exept.de>
parents: 1266
diff changeset
    51
        Claus Gittinger
88
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    52
"
81dacba7a63a *** empty log message ***
claus
parents: 54
diff changeset
    53
! !
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    54
a27a279701f8 Initial revision
claus
parents:
diff changeset
    55
!Boolean class methodsFor:'instance creation'!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    56
a27a279701f8 Initial revision
claus
parents:
diff changeset
    57
basicNew
1119
956d62a5656c compile seldom used methods with optSpace (is this a good idea ?)
Claus Gittinger <cg@exept.de>
parents: 698
diff changeset
    58
    "{ Pragma: +optSpace }"
956d62a5656c compile seldom used methods with optSpace (is this a good idea ?)
Claus Gittinger <cg@exept.de>
parents: 698
diff changeset
    59
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    60
    "catch instance creation
2
claus
parents: 1
diff changeset
    61
     - there must be exactly one instance of each - no more"
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    62
a27a279701f8 Initial revision
claus
parents:
diff changeset
    63
    self error:'new instances of True/False are not allowed'
a27a279701f8 Initial revision
claus
parents:
diff changeset
    64
! !
a27a279701f8 Initial revision
claus
parents:
diff changeset
    65
3
24d81bf47225 *** empty log message ***
claus
parents: 2
diff changeset
    66
!Boolean class methodsFor:'queries'!
24d81bf47225 *** empty log message ***
claus
parents: 2
diff changeset
    67
24d81bf47225 *** empty log message ***
claus
parents: 2
diff changeset
    68
isBuiltInClass
1266
cef9b3cd49df commentary
Claus Gittinger <cg@exept.de>
parents: 1245
diff changeset
    69
    "return true if this class is known by the run-time-system.
cef9b3cd49df commentary
Claus Gittinger <cg@exept.de>
parents: 1245
diff changeset
    70
     Here, true is returned (for my two subclasses)."
3
24d81bf47225 *** empty log message ***
claus
parents: 2
diff changeset
    71
24d81bf47225 *** empty log message ***
claus
parents: 2
diff changeset
    72
    ^ true
1266
cef9b3cd49df commentary
Claus Gittinger <cg@exept.de>
parents: 1245
diff changeset
    73
cef9b3cd49df commentary
Claus Gittinger <cg@exept.de>
parents: 1245
diff changeset
    74
    "Modified: 23.4.1996 / 15:58:22 / cg"
3
24d81bf47225 *** empty log message ***
claus
parents: 2
diff changeset
    75
! !
24d81bf47225 *** empty log message ***
claus
parents: 2
diff changeset
    76
698
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
    77
!Boolean methodsFor:'binary storage'!
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
    78
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
    79
hasSpecialBinaryRepresentation
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
    80
    "return true, if the receiver has a special binary representation"
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
    81
3070
1bf5a29fddc9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 2416
diff changeset
    82
    ^ true
1bf5a29fddc9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 2416
diff changeset
    83
1bf5a29fddc9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 2416
diff changeset
    84
    "Modified: / 2.11.1997 / 14:13:56 / cg"
698
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
    85
! !
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
    86
422
claus
parents: 384
diff changeset
    87
!Boolean methodsFor:'converting'!
claus
parents: 384
diff changeset
    88
2416
588d5d510c10 literal encodings
Claus Gittinger <cg@exept.de>
parents: 1294
diff changeset
    89
decodeAsLiteralArray
588d5d510c10 literal encodings
Claus Gittinger <cg@exept.de>
parents: 1294
diff changeset
    90
    "given a literalEncoding in the receiver,
588d5d510c10 literal encodings
Claus Gittinger <cg@exept.de>
parents: 1294
diff changeset
    91
     create & return the corresponding object.
588d5d510c10 literal encodings
Claus Gittinger <cg@exept.de>
parents: 1294
diff changeset
    92
     The inverse operation to #literalArrayEncoding."
588d5d510c10 literal encodings
Claus Gittinger <cg@exept.de>
parents: 1294
diff changeset
    93
588d5d510c10 literal encodings
Claus Gittinger <cg@exept.de>
parents: 1294
diff changeset
    94
    ^ self
588d5d510c10 literal encodings
Claus Gittinger <cg@exept.de>
parents: 1294
diff changeset
    95
588d5d510c10 literal encodings
Claus Gittinger <cg@exept.de>
parents: 1294
diff changeset
    96
    "Created: 25.2.1997 / 19:16:43 / cg"
588d5d510c10 literal encodings
Claus Gittinger <cg@exept.de>
parents: 1294
diff changeset
    97
    "Modified: 25.2.1997 / 19:17:45 / cg"
588d5d510c10 literal encodings
Claus Gittinger <cg@exept.de>
parents: 1294
diff changeset
    98
!
588d5d510c10 literal encodings
Claus Gittinger <cg@exept.de>
parents: 1294
diff changeset
    99
422
claus
parents: 384
diff changeset
   100
literalArrayEncoding
1245
c8afea3d5af0 commentary
Claus Gittinger <cg@exept.de>
parents: 1119
diff changeset
   101
    "encode myself as an array literal, from which a copy of the receiver
c8afea3d5af0 commentary
Claus Gittinger <cg@exept.de>
parents: 1119
diff changeset
   102
     can be reconstructed with #decodeAsLiteralArray."
422
claus
parents: 384
diff changeset
   103
claus
parents: 384
diff changeset
   104
    ^ self
claus
parents: 384
diff changeset
   105
claus
parents: 384
diff changeset
   106
    "Modified: 5.9.1995 / 22:46:57 / claus"
1245
c8afea3d5af0 commentary
Claus Gittinger <cg@exept.de>
parents: 1119
diff changeset
   107
    "Modified: 22.4.1996 / 13:00:05 / cg"
422
claus
parents: 384
diff changeset
   108
! !
claus
parents: 384
diff changeset
   109
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   110
!Boolean methodsFor:'copying'!
a27a279701f8 Initial revision
claus
parents:
diff changeset
   111
159
514c749165c3 *** empty log message ***
claus
parents: 92
diff changeset
   112
copy
514c749165c3 *** empty log message ***
claus
parents: 92
diff changeset
   113
    "return a shallow copy of the receiver
514c749165c3 *** empty log message ***
claus
parents: 92
diff changeset
   114
     - since both true and false are unique, return the receiver"
514c749165c3 *** empty log message ***
claus
parents: 92
diff changeset
   115
514c749165c3 *** empty log message ***
claus
parents: 92
diff changeset
   116
    ^ self
514c749165c3 *** empty log message ***
claus
parents: 92
diff changeset
   117
!
514c749165c3 *** empty log message ***
claus
parents: 92
diff changeset
   118
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   119
deepCopy
a27a279701f8 Initial revision
claus
parents:
diff changeset
   120
    "return a deep copy of the receiver
a27a279701f8 Initial revision
claus
parents:
diff changeset
   121
     - since both true and false are unique, return the receiver"
a27a279701f8 Initial revision
claus
parents:
diff changeset
   122
a27a279701f8 Initial revision
claus
parents:
diff changeset
   123
    ^ self
12
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   124
!
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   125
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   126
deepCopyUsing:aDictionary
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   127
    "return a deep copy of the receiver
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   128
     - since both true and false are unique, return the receiver"
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   129
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   130
    ^ self
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   131
!
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   132
698
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   133
shallowCopy
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   134
    "return a shallow copy of the receiver
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   135
     - since both true and false are unique, return the receiver"
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   136
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   137
    ^ self
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   138
!
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   139
12
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   140
simpleDeepCopy
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   141
    "return a deep copy of the receiver
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   142
     - since both true and false are unique, return the receiver"
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   143
8e03bd717355 *** empty log message ***
claus
parents: 5
diff changeset
   144
    ^ self
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   145
! !
a27a279701f8 Initial revision
claus
parents:
diff changeset
   146
698
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   147
!Boolean methodsFor:'printing & storing'!
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   148
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   149
printOn:aStream
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   150
    "append a character sequence representing the receiver to the argument,
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   151
     aStream"
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   152
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   153
    aStream nextPutAll:self printString
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   154
!
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   155
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   156
storeOn:aStream
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   157
    "append a character sequence to the argument, aStream from which the
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   158
     receiver can be reconstructed using readFrom:."
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   159
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   160
    ^ self printOn:aStream
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   161
!
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   162
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   163
storeString
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   164
    "return  a character sequence to the argument, aStream from which the
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   165
     receiver can be reconstructed using readFrom:."
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   166
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   167
    ^ self printString
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   168
! !
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   169
379
5b5a130ccd09 revision added
claus
parents: 281
diff changeset
   170
!Boolean methodsFor:'queries'!
5b5a130ccd09 revision added
claus
parents: 281
diff changeset
   171
5b5a130ccd09 revision added
claus
parents: 281
diff changeset
   172
isLiteral
5b5a130ccd09 revision added
claus
parents: 281
diff changeset
   173
    "return true, if the receiver can be used as a literal
5b5a130ccd09 revision added
claus
parents: 281
diff changeset
   174
     (i.e. can be used in constant arrays)"
5b5a130ccd09 revision added
claus
parents: 281
diff changeset
   175
5b5a130ccd09 revision added
claus
parents: 281
diff changeset
   176
    ^ true
5b5a130ccd09 revision added
claus
parents: 281
diff changeset
   177
! !
5b5a130ccd09 revision added
claus
parents: 281
diff changeset
   178
698
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   179
!Boolean class methodsFor:'documentation'!
54
06dbdeeed4f9 *** empty log message ***
claus
parents: 37
diff changeset
   180
698
04533375e12c checkin from browser
Claus Gittinger <cg@exept.de>
parents: 528
diff changeset
   181
version
3070
1bf5a29fddc9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 2416
diff changeset
   182
    ^ '$Header: /cvs/stx/stx/libbasic/Boolean.st,v 1.22 1997-11-02 17:03:45 cg Exp $'
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
   183
! !