Predefined Functions - Siemens SINUMERIK 808D ADVANCED Series Commissioning Manual

14.9

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
ncfunc.cap.write
346
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.
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>
The function writes a value into the specified variable. If the write
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.
Syntax:
<function name="ncfunc.cap.write" return="error">
local variable or constant, "address"</function>
Example:
<let name="error"></let>
<function name="ncfunc.cap.write" return="error">
0, "drive/cu/p0009"</function>
<if>
<condition>error != 0</condition>
<then>
<break />
</then>
</if>
Commissioning Manual
6FC5397-4EP10-0BA8, 07/2018