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
    - udpClose()
      Closes the connection to a UDP socket.
    - udpOpen()
      Opens a connection to a UDP socket.
    - udpRead()
      Reads the data from a UDP socket.
    - udpWrite()
      Writes data to the passed UDP socket (host).
    - uiConnect()
      The function allows you to connect to a specific event with a callback function and call this callback function in case the connected event is triggerd. This is a similar behavior to e.g. ControlA_D/dpConnect.html
    - uiConnectUserData()
      The function allows to connect to a specific event with a callback function and call this callback function in case the connected event is triggerd. This is a similar behavior to e.g. dpConnect(). Additionally to uiConnect() specific user data can be passed to the callback function.
    - uiDisconnect()
      The function allows to disconnect previously established connections of the functions uiConnect() and uiConnectUserData().
    - uniDynPatternMatch()
      Checks whether particular strings in a dynamic field have a specific pattern.
    - uniFPrintf()
      Writes to a file.
    - uniFPrintfPL()
      Writes to a file similar to uniFPrintf() except changes to the current WinCC OA language before converting.
    - uniFPrintfUL()
      Writes to a file similar to uniFPrintf() except changes to the current Windows user language before converting.
    - uniPatternMatch()
      Checks whether particular string have a specific pattern.
    - uniSPrintf()
      Formats a string.
    - uniSPrintfUL()
      Formats a string.
    - uniStrChange()
      Changes the content of a string at a specific index for a defined count of digits with a replacing string.
    - uniStrExpand()
      Returns a formatted string.
    - uniStrFormat()
      Returns a formatted string.
    - uniStrLen()
      Returns the length of a string.
    - uniStrPos()
      Returns the position of a string within another.
    - uniStrReplace()
      Replaces parts of a string with another string.
    - uniStrTok()
      Searches a string for the first occurrence of any of a set of characters.
    - uniStrToLower()
      Changes a string to lowercase.
    - uniStrToUpper()
      Converts a lower-case string to a string in capital letters.
    - uniSubStr()
      Cuts a string or a character of a certain length (characters) out of another string.
    - unzip()
      The function unpacks a file into a specified directory.
    - uploadPreparedValues()
      The method uploads values from the internal data structure to MindSphere.
    - useQueryRDBDirect()
      The function checks if RDB (Oracle) is used for queries.
    - useRDBArchive()
      The function useRDBArchive() checks if RDB archives are used for the archiving in a project.
    - useRDBGroups()
      The function useRDBGroups() checks if RDB groups are used for archiving.
    - userDefFunc()
      Calls C++ functions.
    - usesTouchScreen()
      Query if the UI is currently using touch-input mode or mouse mode..
    - useValueArchive()
      The function checks whether the valueArchive archiving is used.
    - usr_deleteSetting()
      Deletes a user setting from the configuration management.
    - uss_getGenericSetting()
      Reads all user or user group settings without hierarchy.
    - uss_getMyUsergroup()
      Returns the user group with the lowest position ID.
    - uss_getSpecificSetting()
      Reads a specific user(group) setting without hierarchy.
    - uss_getSpecificUserSetting()
      Reads a specific user setting with hierarchy.
    - uss_getUserSettings()
      Reads all user settings with hierarchy.
  - Functions V
  - Functions W
  - Functions X
  - Functions Y
  - Functions Z
- CTRL Debugger
  With the CTRL Debugger you can debug the programming language Control.

udpRead()

Reads the data from a UDP socket.

Synopsis

int udpRead( int socket, string/blob &data, string &host, unsigned &port, time maxTimeout);

Parameters


Parameter	Description
socket	Number of the socket (to which the function udpOpen() established a connection).
data	Data to be read. If you use a string and the data contains 0 bytes, the function replaces each of the 0 bytes by "." and the log viewer shows a message.
host	Return parameter. Host from which the data was sent.
port	Return parameter. Port over which the data was sent.
maxTimeout	Time range the function waits for the data.

Return value

0 if the function starts correctly (the timeout starts), in case of parameter errors -1. You can retrieve errors by using getLastError().

Error

Missing or wrong arguments.

Description

Reads the data from a UDP socket. In the return parameters host and port the sender of the data and sending port are returned. The host is always returned in numerical form to avoid delays due to host name lookup. To determine the host name, the function getHostByAddr() has to be called afterwards.

Example

Opens the connection to a UDP socket via udpOpen() and reads the data of the opened socket via udpRead().

main()
{
  int read, open;
  time maxTime;
  string data;
  time maxTime = 100;
  unsigned openPort, writePort;
  string writeHost;
  openPort = 120;
  open = udpOpen("eiwnt094", openPort);
  DebugN(open);
  read = udpRead(open, data, writeHost, writePort, maxTime);
  DebugN(data, writeHost, writePort); 
}

Assignment

Communication functions

Availability

CTRL