Skip to content

Commit f65fbc7

Browse files
committed
More info for #2653
1 parent df30367 commit f65fbc7

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

doc/Type/IO/Handle.pod6

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1104,7 +1104,10 @@ C<WRITE>, which stores every line in an element in an array. The C<read> method
11041104
actually calls C<READ>, returning 3 bytes, which correspond to the three
11051105
characters in the first two elements. Please note that it's the C<IO::Handle>
11061106
base class the one that is taking care of cursor, since C<READ> just provides a
1107-
handle into the whole content of the object.
1107+
handle into the whole content of the object; the base class will C<READ> 1024 *
1108+
1024 bytes at a time. If your object is planned to hold an amount of bytes
1109+
bigger than that, you will have to handle an internal cursor yourself. That is
1110+
why in this example we don't actually use the C<bytes> argument.
11081111
11091112
=head2 method EOF
11101113
@@ -1116,7 +1119,8 @@ Indicates whether "end of file" has been reached for the B<data source> of the
11161119
handle; i.e. no more data can be obtained by calling L<C«.READ»|/routine/READ>
11171120
method. Note that this is B<not> the same as L<eof|/routine/eof> method, which
11181121
will return C<True> only if C<.EOF> returns C<True> B<and all the decoder
1119-
buffers>, if any were used by the handle, are also empty.
1122+
buffers>, if any were used by the handle, are also empty. See
1123+
L<C«.READ»|/routine/READ> for an example implementation.
11201124
11211125
=head1 Related roles and classes
11221126

0 commit comments

Comments
 (0)