Difference between revisions of "MC-Basic:ACCEPT"
m |
|||
| (28 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | {{Languages|MC-Basic:ACCEPT}} | ||
| + | {{MC-Basic | ||
| + | |SHORT FORM= | ||
| + | |||
| + | |||
| + | |SYNTAX= | ||
| + | Accept({#<''listening device number''>}, #<''accepting device number''>, <''port number''>) | ||
| + | |||
| + | |AVAILABILITY= | ||
| + | |||
| + | |||
| + | |DESCRIPTION= | ||
| + | Binds a TCP socket to specific port and accepts a connection. Listens to a TCP socket. | ||
| + | The <''port number''> defines TCP port. | ||
| + | |||
| + | |TYPE= | ||
| + | <''listening device number''>: Long | ||
| + | |||
| + | <''accepting device number''>: Long<br> | ||
| + | |||
| + | <''port number''>: Long | ||
| + | |||
| + | |||
| + | |||
| + | |RANGE= | ||
| + | <''listening device number''>: 1 to 255 | ||
| + | |||
| + | <''accepting device number''>: 1 to 255<br> | ||
| + | |||
| + | <''port number''>: 6000 through 6999 | ||
| + | |||
| + | |UNITS= | ||
| + | |||
| + | |||
| + | |DEFAULT= | ||
| + | |||
| + | |||
| + | |SCOPE= | ||
| + | Task | ||
| + | |||
| + | |LIMITATIONS= | ||
| + | Task only | ||
| + | |||
| + | Errors: | ||
| + | |||
| + | *Invalid socket<br> | ||
| + | *Cannot accept connection | ||
| + | |||
| + | |EXAMPLE= | ||
| + | '''EXAMPLE''' | ||
| − | |||
Accept(#1,65456) | Accept(#1,65456) | ||
| − | + | '''EXAMPLE - Since Version 4.0.14''': | |
Dim X as long = 2 | Dim X as long = 2 | ||
| − | OpenSocket Options=1 as #1 | + | OpenSocket Options=1 as #1 'explicit socket open for listening for port |
while TRUE | while TRUE | ||
| − | OpenSocket Options=1 as #X | + | OpenSocket Options=1 as #X 'explicit socket open for listening accepting a new connection |
| − | |||
| − | |||
Accept(#1, #X, 6002) | Accept(#1, #X, 6002) | ||
| Line 21: | Line 68: | ||
End while | End while | ||
| − | + | '''Where''': | |
| − | Where: | + | * Listening device is permanent and bound to the port. It can be closed only when listener is terminated. |
| − | * | + | * Accepting device[x] is created each time a listener creates new server task. |
| − | * | + | * Application cannot close accepting device[x] when it is accepting. |
| − | * Application cannot close | ||
|SEE ALSO= | |SEE ALSO= | ||
| − | * [[ | + | * [[MC-Basic:CLOSE|CLOSE]] |
| − | * [[ | + | * [[MC-Basic:CONNECT|CONNECT]] |
| − | * [[ | + | * [[MC-Basic:OPENSOCKET|OPENSOCKET]] |
| − | * [[ | + | * [[MC-Basic:PING|PING]] |
| − | + | <!-- [[Category:MC-Basic:Communication|ACCEPT]] --> | |
| − | |||
}} | }} | ||
Latest revision as of 09:50, 18 July 2019
| Language: | English • 中文（简体） |
|---|
Binds a TCP socket to specific port and accepts a connection. Listens to a TCP socket. The <port number> defines TCP port.
Syntax
Accept({#<listening device number>}, #<accepting device number>, <port number>)
Type
<listening device number>: Long
<accepting device number>: Long
<port number>: Long
Range
<listening device number>: 1 to 255
<accepting device number>: 1 to 255
<port number>: 6000 through 6999
Scope
Task
Limitations
Task only
Errors:
- Invalid socket
- Cannot accept connection
Examples
EXAMPLE
Accept(#1,65456)
EXAMPLE - Since Version 4.0.14:
Dim X as long = 2
OpenSocket Options=1 as #1 'explicit socket open for listening for port
while TRUE
OpenSocket Options=1 as #X 'explicit socket open for listening accepting a new connection
Accept(#1, #X, 6002)
X=X+1
End while
Where:
- Listening device is permanent and bound to the port. It can be closed only when listener is terminated.
- Accepting device[x] is created each time a listener creates new server task.
- Application cannot close accepting device[x] when it is accepting.