Difference between revisions of "FSOCKOPEN()"
From Recital Documentation Wiki
Yvonnemilne (Talk | contribs) |
Yvonnemilne (Talk | contribs) |
||
| (3 intermediate revisions by one user not shown) | |||
| Line 1: | Line 1: | ||
| − | + | ==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== | ||
| + | <code lang="recital"> | ||
| + | fp=fsockopen("www.server.com",80) | ||
| + | if fp > 0 | ||
| + | ... | ||
| + | endif | ||
| + | fclose(fp) | ||
| + | </code> | ||
| + | |||
| + | ==Products== | ||
| + | Recital, Recital Server | ||
| + | [[Category:Documentation]] | ||
| + | [[Category:Functions]] | ||
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
