ReadWriteStream.st
author Claus Gittinger <cg@exept.de>
Thu, 21 Mar 1996 16:33:40 +0100
changeset 1113 840b03d131d7
parent 970 3b59c9b38dbb
child 1295 83f594f05c52
permissions -rw-r--r--
category changes; lock changeFileUpdates via a semaphore (for slow background checkins)
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
329
claus
parents: 93
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
970
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    13
'From Smalltalk/X, Version:2.10.8 on 6-feb-1996 at 15:31:35'                    !
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    14
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    15
WriteStream subclass:#ReadWriteStream
970
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    16
	instanceVariableNames:''
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    17
	classVariableNames:''
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    18
	poolDictionaries:''
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    19
	category:'Streams'
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    20
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    21
611
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    22
!ReadWriteStream class methodsFor:'documentation'!
88
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    23
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    24
copyright
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    25
"
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    26
 COPYRIGHT (c) 1989 by Claus Gittinger
329
claus
parents: 93
diff changeset
    27
	      All Rights Reserved
88
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    28
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    29
 This software is furnished under a license and may be used
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    30
 only in accordance with the terms of that license and with the
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    31
 inclusion of the above copyright notice.   This software may not
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    32
 be provided or otherwise made available to, or used by, any
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    33
 other person.  No title to or ownership of the software is
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    34
 hereby transferred.
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    35
"
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    36
!
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    37
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    38
documentation
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    39
"
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    40
    ReadWriteStreams allow both read- and write-access to some collection.
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    41
    To allow this, they reenable some methods blocked in WriteStream.
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    42
    (being one of the seldom places, where multiple inheritance could be
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    43
     of good use in smalltalk).
329
claus
parents: 93
diff changeset
    44
claus
parents: 93
diff changeset
    45
    Claus:
claus
parents: 93
diff changeset
    46
	I personally find the ReadStream - WriteStream - ReadWriteStream
claus
parents: 93
diff changeset
    47
	organization brain-damaged. It would be better to have an attribute
claus
parents: 93
diff changeset
    48
	(such as readOnly / writeOnly / readWrite) in an InternalStream subclass 
claus
parents: 93
diff changeset
    49
	of Stream ...
88
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    50
"
329
claus
parents: 93
diff changeset
    51
! !
claus
parents: 93
diff changeset
    52
345
claus
parents: 329
diff changeset
    53
!ReadWriteStream methodsFor:'access-reading'!
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    54
a27a279701f8 Initial revision
claus
parents:
diff changeset
    55
next
41
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    56
    "return the next element; advance read position.
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    57
     If there are no more elements, nil is returned."
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    58
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    59
    |element|
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    60
970
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    61
    (position > readLimit) ifTrue:[^ self pastEnd].
41
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    62
    element := collection at:position.
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    63
    position := position + 1.
41
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    64
    ^ element
970
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    65
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    66
    "Modified: 5.2.1996 / 21:57:40 / stefan"
611
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    67
!
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    68
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    69
peek
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    70
    "return the element to be read next without advancing read position.
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    71
     If there are no more elements, nil is returned."
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    72
970
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    73
    (position > readLimit) ifTrue:[^ self pastEnd].
611
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    74
    ^ collection at:position
970
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    75
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
    76
    "Modified: 5.2.1996 / 21:57:47 / stefan"
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    77
! !
611
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    78
677
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
    79
!ReadWriteStream methodsFor:'converting'!
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
    80
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
    81
readStream
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
    82
    ^ self
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
    83
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
    84
    "Created: 29.11.1995 / 22:04:23 / stefan"
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
    85
! !
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
    86
611
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    87
!ReadWriteStream methodsFor:'positioning'!
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    88
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    89
reset
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    90
    "re-redefine to not clobber the collection"
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    91
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    92
    position := "0" 1
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    93
! !
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    94
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    95
!ReadWriteStream methodsFor:'queries'!
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    96
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    97
isReadable 
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    98
    ^ true
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    99
! !
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
   100
677
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
   101
!ReadWriteStream class methodsFor:'documentation'!
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
   102
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
   103
version
970
3b59c9b38dbb ST80 compatibility: generate signal at end of stream when instance variable
Stefan Vogel <sv@exept.de>
parents: 701
diff changeset
   104
    ^ '$Header: /cvs/stx/stx/libbasic/ReadWriteStream.st,v 1.16 1996-02-19 15:07:27 stefan Exp $'
677
9ab491d2a2b4 Need methot readStream.
Stefan Vogel <sv@exept.de>
parents: 611
diff changeset
   105
! !