String to REAL (STOR)

This information applies to the CompactLogix 5370, ControlLogix 5570, Compact GuardLogix 5370, GuardLogix 5570, Compact GuardLogix 5380, CompactLogix 5380, CompactLogix 5480, ControlLogix 5580, and GuardLogix 5580 controllers.
The String to REAL (STOR) instruction converts the ASCII representation of a floating-point value to a REAL value.
Available Languages
Ladder Diagram
STOR_LD_avail_v31
Function Block
This instruction is not available in function block.
Structured Text
STOR(Source,Dest);
Operands
There are data conversion rules for mixed data types within an instructions. See
Data Conversion
.
Ladder Diagram and Structured Text
Operand
Type
Format
Description
Notes
Source
String type
tag
The tag that contains the value in ASCII
String types are:
  • Default STRING data type
  • Any new string type you create
Destination
REAL
tag
The tag to store the REAL value
Structured Text for more information on the syntax of expressions within structured text.
Description
The STOR instruction converts the Source to a REAL value and places the result in the Destination.
  • The instruction converts positive and negative numbers.
  • If the Source string contains non-numeric characters, the STOR converts the first set of contiguous numbers, including the decimal point [.].
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.
Affects Math Status Flags
Conditional, based on programming language. See
Math Status Flags
.
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.
  • Reduce the size of the ASCII value, or
  • Use a larger data type for the destination
See
Common Attributes
for operand-related faults.
Execution
Ladder Diagram
Condition
Ladder Diagram Action
Prescan
N/A
Rung-condition-in is false
N/A
Rung-condition-in is true
The instruction executes.
Postscan
N/A
Structured Text
Condition
Action
Prescan
See Prescan in the preceding Ladder Diagram table
Normal execution
See rung-condition-in is true in the preceding Ladder Diagram table.
Postscan
See Postscan in the preceding Ladder Diagram table
Example
After reading the weight from a scale (weight_read is set), the STOR instruction converts the numeric characters in weight_ascii to a REAL value.
You may see a slight difference between the fractional parts of the Source and Destination.
Ladder Diagram
STOR_LD_ex_v31
Structured Text
IF weight_read THEN
STOR(weight_ascii,weight);
END_IF;
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.