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.
    - urlDecode()
      The function decodes a percent-encoded URL into a regular string.
    - urlEncode()
      The function encodes a string into a percent-encoded string to be used within a URL.
    - 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.
    - useSQLite()
      The function checks if an SQLite database is used.
    - 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, basics
- CTRLPPCheck
  Save time and money with increased code quality in your projects

uniStrFormat()

Returns a formatted string.

Synopsis

string uniStrformat( string format, int len, anytype value);

Parameters


Parameter	Description
format	Format of the string
len	Length of the string
value	Variables to be used

Return value

If successful, the formatted string, otherwise an empty string.

Description

uniStrformat() returns a string in accordance with the format string format in the length len , while using the variables value . The type of value is automatically recognized. Syntax for the format string:

The format string basically comprises two parts:

<align_switch> <var_format>

The first part <align_switch> defines the alignment of the text and can assume the following values:

\\left \\center \\right \\fill


Parameter	Description
\\left	left-justified
\\center	centered
\\right	right-justified
\\fill	justified

The second part <var_format> comprises several components:

{[any_string][%<total field_length including commas and digits before the decimal place as well as decimal places>[any_string]}"

The following code lines:

float i;

i=3457.428;

/* The total length is 8 and there are 3 decimal places, therefore the number 8.3 is used*/

DebugN(uniStrFormat("\\left{%8.3 Kilometers}", 19, i));

Would look as follows:

WCCOAui1: ["3457.428 Kilometers"]

The following code lines:

float i;

i=1.23;

DebugN(uniStrFormat("\\left{Here are%5.2 Kilograms}", 24,i));

/* The total length is 5 since a blank should be added after the word "are". Therefore, the number 5.2 is used (blank1.23). Since two decimal places are output, the number is 5.2*/

Would looks as follows:

WCCOAui1: ["Here are 1.23 Kilograms"]

The any_strings at the beginning and end are directly inserted in front of or after the value, and may, for example, contain the unit of the value.

The following restrictions apply:

<align_switch> is NOT optional, otherwise an empty string is generated!

<align_switch> defines the alignment of the text located between "{" and "}".

Example

 main()
{
  float i;
  i=12.3;
  DebugN(uniStrFormat("\\left{%5.1 Kilograms}", 15, i));
}

The output looks as follows:

WCCOAui1:[" 12.3 Kilograms"]

Assignment

Strings

Availability

CTRL