Siemens SINUMERIK 840DE sl Commissioning Manual page 816

Generating user dialogs
1.10 Predefined functions
1.10 Predefined functions
The script language offers various string processing and standard mathematical functions. The
function names listed below are reserved and cannot be overloaded.
Function name
Ncfunc cap read
98
Description
The function copies a value from the specified address into a local
variable. If the read operation was error-free, then the return variable
contains the value zero.
Contrary to the operation instruction, in the event of a fault, this func‐
tion does not interrupt the processing of the script operations.
Attributes:
● return - Execution status
– Value = 0 - fault-free
– Value = 1 - The variables could not be read
● rows - Number of additional lines of an array to be read (optional)
If an array index is defined for the reference variables, as from this
index, the function copies the values read into the target variable.
Syntax:
<function name="ncfunc.cap.read" return="error">
lokale variable, "address"</function>
Example:
<let name="error"></let>
<function name="ncfunc.cap.read" return="error">
3, "drive/cu/p0009"</function>
<if>
<condition>error != 0</condition>
<then>
<break />
</then>
</if>
or
<let name="cu_p978" dim="25" ></let>
...
...
<function name="ncfunc.cap.read" return="error"
rows="23">cu_p978, "drive/cu/p0978[0, 1]"</
function>
Programming Manual, 12/2017, 6FC5397-1DP40-6BA1
Easy XML