String to DINT (STOD)
The STOD instruction converts the ASCII representation of an integer to an integer or REAL value.
The STOD instruction converts the Source to an integer and places the result in the Destination.
- The instruction converts positive and negative numbers.
- If the Source string contains non-numeric characters, the STOD converts the first set of contiguous numbers:
The instruction skips any initial control or non-numeric characters, except the minus sign in front of a number.
If the string contains multiple groups of numbers that are separated by delimiters (e.g., /), the instruction converts only the first group of numbers.
Available Languages
Ladder Diagram
FactoryTalk Design Studio
DSL - Ladder DiagramSTOD(Source,Dest);
Operands
There are data conversion rules for mixed data types within an instructions. See Data Conversion.
Ladder Diagram
Operand | Type | Format | Description | Notes |
---|---|---|---|---|
Source | String type | Tag | The tag that contains the value in ASCII | String types are:
|
Destination | SINT
INT
DINT | Tag | The tag to store the integer value | If the Source value is a floating-point number, the instruction converts only the non-fractional part of the number (regardless of the destination data type). |
Affects Math Status Flags
In Ladder Diagrams only.
Major/Minor Faults
Type | Code | Cause | Recovery Method |
---|---|---|---|
4 | 51 | The LEN value of the string tag is greater than the DATA size of the string tag. | Check that no instruction is writing to the LEN member of the string type tag. In the LEN value, enter the number of characters that the string contains. |
4 | 53 | The output number is beyond the limits of the destination data type. |
|
See Index through arrays for operand-related faults.
Execution
Ladder Diagram
Condition | Action Taken |
---|---|
Prescan | N/A |
Rung-condition-in is false | N/A |
Rung-condition-in is true | The instruction executes. Destination is cleared The instruction converts the Source. |
Postscan | N/ |
Provide Feedback