%connect() function

The %connect() function requests a connection between two sockets.


code = %connect(fd, addr.family, host, port)


fd File descriptor of the local socket returned by a previous call to the FlashBASIC C function %socket().
addr.family Specifies the addressing scheme used by the protocol. This field must match the address family used when creating the socket. Valid values are defined in the include file: dm,bp,unix.h socket.h.
host Destination host name. The string must be known to the local network manager. Internally, this calls getaddrinfo to resolve the remote host.
port Port number on the distant host. Legal value for this field depends on the protocol. On TCP/IP, for example, valid port numbers are from 1024 to 32767.


To compile successfully, the statement cfunction socket.builtin must be included in the source code.

Upon successful completion, a value of 0 is returned in code. In case of error, a value of -1 is returned and the system(0) function is set to the value of errno.

The connection is closed when the socket is closed.


cfunction socket.builtin
include dm,bp,includes sysid.inc
include dm,bp,unix.h socket.h
* Create a socket
* Connect to the distant host
if %connect(fd,af$inet,"prod",1024)<0 then
   crt ’Connect failed’; stop
* Write data to it
* Terminate connection