socket.read

Syntax

b = socket.read(a,i1,s<,i2>)

Read FISH variables through a socket. The FISH variables are placed in the specified FISH array. Currently, only parameters of type Integer, Real, String, or Vector can be sent or received via sockets.

Note

A call to socket.read does not return until the requested number of items has been received. Therefore, a process will appear to “lock up” if insufficient data have been sent by the sending process.

Note

See the parameter encoding detailed in socket.write for connections to non-FISH sockets.

Returns:

b - socket read status

Arguments:

a - array pointer

i1 - number of FISH variables to receive

s - socket pointer or integer specifying the channel number with value from 0 to 5

i2 - optional number of seconds to wait for the connection with default value of 30 seconds