|
|
|
|
|
|
|
METHOD: |
|
|
|
|
read |
|
|
|
|
|
|
|
|
|
DESCRIPTION: |
|
|
|
|
Reads character or binary data from a stream object. |
||
|
|
|
|
|
|
|
PROPERTY OF: |
|
|
|
|
|
||
|
|
|
||
|
|
SYNTAX: |
|
|
|
|
<oRef>.read([<num expN>]) |
|
|
|
|
<oRef> |
|
|
|
|
The stream object. |
|
|
|
|
<num expN> |
|
|
|
|
The number of characters or bytes; may be contain the negative constant : |
||
|
|
-1 (Reads all characters or bytes from the stream, from the current position to EOS) (Default) |
||
|
|
-2 (Reads the next line, seperated by lineSeparator type, from the text streams) |
||
|
|
|
|
|
|
|
|
||
|
|
DESCRIPTION: |
|
|
|
|
This method for text streams reads a specified number of characters, |
||
|
|
an entire line, or the entire stream from a Stream object and returns the resulting string. |
||
|
|
For binary streams reads a specified number of bytes or the entire stream from a stream object and returns the resulting string. |
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
|
|