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 )
|