CONTROL
- Introduction to CTRL
  An introduction to the product's own programming language Control(CTRL).
- CONTROL Classes
- Types of Control Functions
  An overview of the types of functions distinguished within Control.
- Control graphics
- CONTROL Functions
  - Functions A
  - Functions B
  - Functions C
  - Functions 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.
- CtrlExtension
  The CtrlExtension allows the addition of custom C++ code.

uniSubStr()

Cuts a string or a character of a certain length (characters) out of another string.

Synopsis

string uniSubStr( string s, int pos [, int len]);

Parameters


Parameter	Description
s	Original string
pos	Starting position of the string to be cut out
len	Number of characters to be cut out

Return value

Shortened string; if pos is greater than the length (characters) of s , if len is smaller than 1 or if any other error occurs, an empty string is returned.

Errors

missing or incorrect arguments

Description

Cuts len characters out of the string s from position pos and returns this substring. The first character of the string s is pos 0, the second character of the string is pos 1, and so forth.

If the optional parameter is omitted, the substring is returned from pos to the end of s .

Example

main()
{
  /*uniSubStr cuts a string of a certain length at a specific
  position out of another string */
  string suS = "This is a sentence with strings";
  int pos = 19;
  int len = 12;
  string b = uniSubStr(suS, pos, len);
  DebugN("The cut string:", b);
}

Assignment

Strings

Availability

CTRL