Conversion instructions
210
Part II IEC Instructions
BOOL_TO_STRING
BOOL into STRING
To add an enable input and enable output to the instruction, select [With EN/ENO] from the
"Instructions" pane (LD, FBD or IL editor). To reuse an instruction select "Recently used" from the
context menu or press <Ctrl>+<Shift>+<v> in the programming window.
PLC types
Availability of BOOL_TO_STRING (see page 1318)
When using the data type STRING with small PLCs like FP-e or FP0,
make sure that the length of the result string is equal to or greater than
the length of the source string.
For further information refer to the online help: Upgrade Problems with
Data Type STRING
Data type I/O Function
BOOL input input data type
STRING output conversion result
The input variable input_value of the data type BOOL is intialized by the value TRUE. The output
variable result_string is of the data type STRING[2]. It can store a maximum of two characters.
You can declare a character string that has more than one character, e.g. STRING[5]. From the 5
characters reserved, only 2 are used.
Instead of using the variable input_value, you can write the constants TRUE or FALSE directly to
the function’s input contact in the body.
Description
The function BOOL_TO_STRING converts a value of the data type BOOL to a value of the data
type STRING[2]. The resulting string is represented by ' 0' or ' 1'.
Data types
Example 1
Result string
= ' 1' or ' 0'
In this example, the same POU header is used for all programming languages. For an example
using IL (instruction list), please refer to the online help.
POU header
All input and output variables used for programming this function have been declared in the POU
header.
Body
The input_value of the data type BOOL is converted into STRING[2]. The converted value is
written to result_string. When the variable input_value = TRUE, result_string shows ' 1'.
LD
ST
When programming with structured text, enter the following:
IF Boolean_value THEN
output_value:=BOOL_TO_STRING(input_value);
END_IF;