Return value(s) read from the specified file input stream, piped input stream, string buffer input stream, data input stream, data input, random access file or input stream object.
Syntax
read( inputstream )
inputstream.read( )
Parameters
inputstream
|
the file input stream, piped input stream, string buffer input stream, random access file, data input stream, data input or input stream or object to use.
|
Returns
integer
|
the byte read.
-1 if end of file was reached.
|
Example
b = fh.read( )
Syntax
read( inputstream , bytearray )
inputstream.read( bytearray )
Parameters
inputstream
|
the file input stream, piped input stream, string buffer input stream, random access file, data input stream, data input or input stream or object to use.
|
bytearray
|
a byte array object to read into.
|
Returns
length
|
the number of bytes read.
-1 if end of file was reached.
|
Example
sz = fh.read( buf )
Syntax
read( inputstream , bytearray , offset , length )
inputstream.read( bytearray , offset , length )
Parameters
inputstream
|
the file input stream, piped input stream, string buffer input stream, random access file, data input stream, data input or input stream or object to use.
|
bytearray
|
a byte array object to read into.
|
offset
|
a starting offset.
|
length
|
the number of bytes to read.
|
Returns
length
|
the number of bytes read.
-1 if end of file was reached.
|
Example
sz = fh.read( buf, 0, 1024 )
|