socket.write

Syntax

v = socket.write(a,i1,s)

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

Note

For connections to sockets created in a language other than FISH, parameters are encoded as described below. First a 32 bit integer is sent indicating the parameter type. The size and encoding that comes next is dependent on the parameter, as described in the table below. All values are little-endien.

Table 1: Socket Parameter Encoding
Code Type Encoding
1 Integer 32 bit (4 byte) signed integer.
2 Real 64 bit (8 byte) double precision floating point value.
3 String 32 bit integer indicating how many bytes are following. This will always be in increments of 4. The string data is not necessarily null terminated.
5 2D Vector Two 64 bit (8 byte) double precision floating point values.
6 3D Vector Three 64 bit (8 byte) double precision floating point values.
7 Integer 64 bit (8 byte) signed integer.
8 Boolean 8 bit signed integer. Zero means false. Non-zero means true.
Returns:

v - void return

Arguments:

a - array pointer

i1 - number of FISH variables to send

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