Semiconductor & Computer Engineering
From WikiChip
Difference between revisions of "mirc/commands/sockread"
m (Bot: Adding a template) |
m (Bot: Fixing links) |
||
| Line 67: | Line 67: | ||
* [[$sockerr identifier - mIRC|$sockerr]] | * [[$sockerr identifier - mIRC|$sockerr]] | ||
* [[$sockbr identifier - mIRC|$sockbr]] | * [[$sockbr identifier - mIRC|$sockbr]] | ||
| − | * | + | * {{mIRC|/sockaccept}} |
| − | * | + | * {{mIRC|/sockclose}} |
| − | * | + | * {{mIRC|/socklist}} |
| − | * | + | * {{mIRC|/socklisten}} |
| − | * | + | * {{mIRC|/sockmark}} |
| − | * | + | * {{mIRC|/sockopen}} |
| − | * | + | * {{mIRC|/sockpause}} |
| − | * | + | * {{mIRC|/sockrename}} |
| − | * | + | * {{mIRC|/sockudp}} |
| − | * | + | * {{mIRC|/sockwrite}} |
{{mIRC command list}} | {{mIRC command list}} | ||
[[Category:MIRC commands]] | [[Category:MIRC commands]] | ||
Revision as of 18:59, 5 July 2014
The /sockread command reads bytes from the receive buffer into a specified variable.
Synopsis
/sockread [-fn] [numbytes] <%var|&binvar>
Switches
| Switch | Description |
|---|---|
| f | Forces mIRC to fill the variable with whatever text is in the receive buffer, even if it does not end in a $crlf. |
| n | Reads a $crlf terminated line into a &binvar. If the incoming line does not contain a $crlf, no bytes will be read into &binvar, unless you specify the -f switch. |
Parameters
| Parameter | Description |
|---|---|
| [numbytes] | The number of bytes to read from the receive buffer. |
| [%var/&binvar] | The name of the variable to read the socket buffer into. |
Example
When a socket connection, mySocket, has info waiting to be read from the buffer, store the info into a %myVar variable and echo it to a custom @myBuffer window:
ON 1:SOCKREAD:mySocket:{ var %myVar ; Check for any socket errors; if they exist exit out of the event if ($sockerr > 0) { return } ; Create our jump loop for reading the socket buffer :nextread ; Read the buffer into the %myVar variable sockread %myVar ; Make sure that there is no socket break; if so exist out of the event if ($sockbr == 0) { return } ; If the buffer was empty, set the variable to printable empty space if (%myVar == $null) { %myVar = $chr(160) } ; Make sure our @myBuffer window is open; if not, create it if (!$window(@myBuffer)) { window @myBuffer } ; Echo the contents of the buffer variable into the @myBuffer window echo @myBuffer %myVar ; Go to the jump loop and read the rest of the buffer goto nextread }
Compatibility
Added: mIRC v5.3
Added On: 13/12/97
See Also
- List of commands
- List of identifiers
- $sock
- $sockname
- $sockerr
- $sockbr
- /sockaccept
- /sockclose
- /socklist
- /socklisten
- /sockmark
- /sockopen
- /sockpause
- /sockrename
- /sockudp
- /sockwrite
mIRC commands list