Difference between revisions of "MC-Basic:ACCEPT"
m (1 revision) |
|||
| (32 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | {{Languages|MC-Basic:ACCEPT}} | ||
{{MC-Basic | {{MC-Basic | ||
|SHORT FORM= | |SHORT FORM= | ||
| Line 4: | Line 5: | ||
|SYNTAX= | |SYNTAX= | ||
| − | Accept( | + | Accept({#<''listening device number''>}, #<''accepting device number''>, <''port number''>) |
|AVAILABILITY= | |AVAILABILITY= | ||
| Line 10: | Line 11: | ||
|DESCRIPTION= | |DESCRIPTION= | ||
| − | Binds a TCP socket to specific port and accepts a connection. Listens to a TCP socket. The <''port number''> defines TCP port | + | Binds a TCP socket to specific port and accepts a connection. Listens to a TCP socket. |
| + | The <''port number''> defines TCP port. | ||
|TYPE= | |TYPE= | ||
| − | <'' | + | <''listening device number''>: Long |
| − | <'' | + | <''accepting device number''>: Long<br> |
| − | <''port number''> : Long | + | <''port number''>: Long |
|RANGE= | |RANGE= | ||
| − | <'' | + | <''listening device number''>: 1 to 255 |
| − | <'' | + | <''accepting device number''>: 1 to 255<br> |
| − | <''port number''> : 6000 through 6999 | + | <''port number''>: 6000 through 6999 |
|UNITS= | |UNITS= | ||
| Line 40: | Line 42: | ||
Task only | Task only | ||
| − | + | Errors: | |
| − | Cannot accept connection | + | *Invalid socket<br> |
| + | *Cannot accept connection | ||
|EXAMPLE= | |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 65: | 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. | |
| − | |||
| − | |||
| − | |||
|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.