ReadWriteStream.st
author Claus Gittinger <cg@exept.de>
Thu, 23 Nov 1995 02:32:01 +0100
changeset 611 80bb0f1a7bab
parent 530 07d0bce293c9
child 677 9ab491d2a2b4
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) 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
a27a279701f8 Initial revision
claus
parents:
diff changeset
    13
WriteStream subclass:#ReadWriteStream
611
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    14
	 instanceVariableNames:''
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    15
	 classVariableNames:''
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    16
	 poolDictionaries:''
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    17
	 category:'Streams'
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    18
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    19
611
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    20
!ReadWriteStream class methodsFor:'documentation'!
88
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    21
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    22
copyright
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    23
"
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    24
 COPYRIGHT (c) 1989 by Claus Gittinger
329
claus
parents: 93
diff changeset
    25
	      All Rights Reserved
88
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    26
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    27
 This software is furnished under a license and may be used
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    28
 only in accordance with the terms of that license and with the
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    29
 inclusion of the above copyright notice.   This software may not
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    30
 be provided or otherwise made available to, or used by, any
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    31
 other person.  No title to or ownership of the software is
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    32
 hereby transferred.
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    33
"
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    34
!
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    35
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    36
documentation
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    37
"
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    38
    ReadWriteStreams allow both read- and write-access to some collection.
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    39
    To allow this, they reenable some methods blocked in WriteStream.
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    40
    (being one of the seldom places, where multiple inheritance could be
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    41
     of good use in smalltalk).
329
claus
parents: 93
diff changeset
    42
claus
parents: 93
diff changeset
    43
    Claus:
claus
parents: 93
diff changeset
    44
	I personally find the ReadStream - WriteStream - ReadWriteStream
claus
parents: 93
diff changeset
    45
	organization brain-damaged. It would be better to have an attribute
claus
parents: 93
diff changeset
    46
	(such as readOnly / writeOnly / readWrite) in an InternalStream subclass 
claus
parents: 93
diff changeset
    47
	of Stream ...
88
81dacba7a63a *** empty log message ***
claus
parents: 41
diff changeset
    48
"
611
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    49
!
345
claus
parents: 329
diff changeset
    50
611
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    51
version
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    52
    ^ '$Header: /cvs/stx/stx/libbasic/ReadWriteStream.st,v 1.13 1995-11-23 01:31:50 cg Exp $'
329
claus
parents: 93
diff changeset
    53
! !
claus
parents: 93
diff changeset
    54
345
claus
parents: 329
diff changeset
    55
!ReadWriteStream methodsFor:'access-reading'!
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    56
a27a279701f8 Initial revision
claus
parents:
diff changeset
    57
next
41
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    58
    "return the next element; advance read position.
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    59
     If there are no more elements, nil is returned."
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    60
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    61
    |element|
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    62
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    63
    (position > readLimit) ifTrue:[^ nil].
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    64
    element := collection at:position.
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    65
    position := position + 1.
41
a14247b04d03 *** empty log message ***
claus
parents: 5
diff changeset
    66
    ^ element
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
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    73
    (position > readLimit) ifTrue:[^ nil].
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    74
    ^ collection at:position
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    75
! !
611
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    76
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    77
!ReadWriteStream methodsFor:'positioning'!
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    78
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    79
reset
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    80
    "re-redefine to not clobber the collection"
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    81
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    82
    position := "0" 1
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    83
! !
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    84
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    85
!ReadWriteStream methodsFor:'queries'!
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    86
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    87
isReadable 
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    88
    ^ true
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    89
! !
80bb0f1a7bab checkin from browser
Claus Gittinger <cg@exept.de>
parents: 530
diff changeset
    90