PickBASIC / FlashBASIC

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

Referenced by

1 topic mentions %connect() function in its description.

%connect_starttls() function