%connect() Function

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

Syntax

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

Parameter(s)

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.

Description

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.

Example(s)

cfunction socket.builtin

include dm,bp,includes sysid.inc

include dm,bp,unix.h socket.h

* Create a socket

fd=%socket(af$inet,sock$stream,0)

* Connect to the distant host

if %connect(fd,af$inet,"prod",1024)<0 then

crt ’Connect failed’; stop

end

* Write data to it

msg="CONNECTED"

%send(fd,msg,len(msg))

* Terminate connection

%close(fd)

See Also

%close() Function

%socket() Function

cfunction Statement