Difference between revisions of "FSOCKOPEN()"

From Recital Documentation Wiki
Jump to: navigation, search
 
(One intermediate revision by one user not shown)
Line 1: Line 1:
{{YLM to do}}
 
 
 
==Purpose==
 
==Purpose==
 
Function to open a TCP/IP socket
 
Function to open a TCP/IP socket
Line 14: Line 12:
  
 
==Description==
 
==Description==
The FSOCKOPEN() function opens a TCP/IP socket.  It returns a numeric pointer when the socket is opened successfully, or a -1 if unsuccessful.  The <expC> is the address, <expN> is the port number.  Since the pointer is required to identify an open socket to other functions, always assign the return value to a memory variable.   
+
The FSOCKOPEN() function opens a TCP/IP socket.  It returns a numeric pointer when the socket is opened successfully, or a -1 if unsuccessful.  The <expC> is the hostname of the server, <expN> is the port number.  Since the pointer is required to identify an open socket to other functions, always assign the return value to a memory variable.   
  
  
Line 22: Line 20:
 
==Example==
 
==Example==
 
<code lang="recital">
 
<code lang="recital">
 
+
fp=fsockopen("www.server.com",80)
 +
if fp > 0
 +
    ...
 +
endif
 +
fclose(fp)
 
</code>
 
</code>
  

Latest revision as of 16:05, 1 December 2009

Purpose

Function to open a TCP/IP socket


Syntax

FSOCKOPEN(<expC>, <expN>)


See Also

FCLOSE(), FFLUSH(), FGETS(), FPUTS(), FREAD()


Description

The FSOCKOPEN() function opens a TCP/IP socket. It returns a numeric pointer when the socket is opened successfully, or a -1 if unsuccessful. The <expC> is the hostname of the server, <expN> is the port number. Since the pointer is required to identify an open socket to other functions, always assign the return value to a memory variable.


The FCLOSE() function is used to close a socket which has been opened with FSOCKOPEN().


Example

fp=fsockopen("www.server.com",80)
if fp > 0
    ...
endif
fclose(fp)

Products

Recital, Recital Server