Qore WebSocketUtil Module Reference 1.0

- Main Page
- Related Pages
- Modules
- Namespaces

- Namespace List
- Namespace Members

All Classes Namespaces Functions Variables Groups Pages
Functions | Variables
WebSocketUtil Namespace Reference

the WebSocketUtil namespace contains all the definitions in the WebSocketUtil module More...

## Functions
binary | ws_encode_message (data msg, int op=-1, *bool masked)
| encodes a message for sending over a websocket socket
hash | ws_read_message (Socket sock, *timeout to)
| read and decode a message from a socket More...

## Variables
const | WS_FIN = (1 << 7)
| the final fragment in a message
const | WS_GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11"
| WebSocket GUID.
const | WSCC_AbnormalClosure = 1006
| "Abnormal Closure" code
const | WSCC_GoingAway = 1001
| "Going Away" code
const | WSCC_InternalServerError = 1011
| "Internal Server Error" code
const | WSCC_InvalidData = 1007
| "Invalid Frame Payload Data" code
const | WSCC_MandatoryExt = 1010
| "Mandatory Ext." code
const | WSCC_MessageTooBig = 1009
| "Message Too Big" code
const | WSCC_NormalClosure = 1000
| "Normal Closure" code
const | WSCC_NoStatusRcvd = 1005
| "No Status Rcvd" code
const | WSCC_PolicyViolation = 1008
| "Policy Violation" code
const | WSCC_ProtocolError = 1002
| "Protocol Error" code
const | WSCC_TlsHandshake = 1015
| "TLS Handshake" code
const | WSCC_UnsupportedData = 1003
| "Unsupported Data" code
const | WSCCMap
| maps from close codes to text descriptions
const | WSOP_Binary = 0x2
| binary frame opcode
const | WSOP_Close = 0x8
| connection code opcode
const | WSOP_Continuation = 0x0
| continuation frame opcode
const | WSOP_Ping = 0x9
| ping opcode
const | WSOP_Pong = 0xa
| pong opcode
const | WSOP_Text = 0x1
| text frame opcode
const | WSOPMap
| maps from opcodes to text descriptions

## Detailed Description

the WebSocketUtil namespace contains all the definitions in the WebSocketUtil module

## Function Documentation

hash WebSocketUtil::ws_read_message | ( | Socket | sock,
|  | *timeout | to
| ) |  |

read and decode a message from a socket

Example:
  my hash $h = ws_read_message($sock);

Parameters

  sock | the Socket object to receive the message
  to | an optional read timeout

Returns
  a hash with the following keys:
  - `op:` the operation code (one of WebSocket OpCodes)
  - `masked` a boolean flag indicating if the message was masked or not
  - `msg:` the message received; if a CLOSE opcode is received (see WSOP_Close) then any close message is decoded and included here in text form
  - `close:` the close code (one of WebSocket Close Codes); only included if op is WSOP_Close