CONTROL
- Introduction to CTRL
- CONTROL Classes
- Types of Control Functions
- Control graphics
- CONTROL Functions
  - Funtions A
  - Funtions B
  - Funtions C
  - Funtions D
  - Functions E
  - Functions F
  - Functions G
  - Functions H
  - Functions I
  - Functions J
  - Functions K
  - Functions L
  - Functions M
  - Functions N
  - Functions O
  - Functions P
  - Functions Q
  - Functions R
  - Functions S
  - Functions T
  - Functions U
  - Functions V
  - Functions W
    - waitThread()
      Waits for the end of the specified thread.
    - webSocketClose()
      The function closes the given WebSocket connection. The WebSocket number is the return value of webSocketOpen().
    - webSocketOpen()
      Opens a WebSocket connection to the given url.
    - webSocketRead()
      Tries to retrieve the next message form the WebSocket.
    - webSocketWrite()
      Writes data to the given WebSocket.
    - weekDay()
      Returns the weekday of a time.
    - wf_bottomBar_reload()
      Updates the buttons of the bottomBar of the wizard framework.
    - windowStyle()
      The function windowStyle() can be used to deactivate the control menu or only the minimize box
    - writeAuditBatchEntry()
      The function is used e.g. in production processes and it writes the batch id, the data point element the executed action had an influence on, the data point type, the executed action and the reason why the action was executed.
    - writeAuditEntry()
      The function writeAuditEntry is used to write set point values into the Audit trail panel.
    - writeDictionary()
      Writes the internal translation table to a file.
    - wss_getGenericSetting()
      Reads all workstation settings without hierarchy.
    - wss_getSpecificSetting()
      Reads a specific workstation setting without hierarchy.
    - wss_getSpecificWorkstationSetting()
      Reads a specific workstation setting with hierarchy.
    - wss_getWorkstationSettings()
      Reads all workstation settings with hierarchy.
  - Functions X
  - Functions Y
  - Functions Z
- CTRL Debugger
  With the CTRL Debugger you can debug the programming language Control.
- CtrlExtension, basics

webSocketRead()

Tries to retrieve the next message form the WebSocket.

Synopsis

int webSocketRead(int socket, anytype|string|blob &data [, time maxTimeout])

Parameters


Parameter	Description
socket	The socket number returned by webSocketOpen().
data	Variable in which the read data is stored.
maxtimeout	The maximum timeout. It determines how long the function waits for the message. This timeout is unlimited if no value is given.

Return value

On successful retrieval of a message 0 is returned. If the socket is closed, 1 is returned. On error -1 is returned. On timeout -2 is returned.

Errors

Errors can be network errors, for which getLastError() can be used to get a more detailed error message.

Description

Tries to retrieve the next message from the WebSocket and stores it in the given "data" argument. When no message was received yet, it waits until the given maxTimeout.

Assignment

WebSocket functions

Availability

CTRL