TO_LREAL-Baustein
Kurz-Information
Name |
TO_LREAL |
→POE-Typ |
|
Kategorie |
|
Konform zur →IEC-Norm |
derzeit eingeschränkt und i mplementierungsabhängige Realisierung; siehe "Funktionalität" und
mehr als in IEC-Norm vorgesehen möglich; "Explizite Konvertierung laut IEC-Norm"
|
Grafische Schnittstelle |
|
Verfügbar ab |
|
Funktionalität
Der Baustein dient zur expliziten Konvertierung des an IN anliegenden Werts in einen Wert vom Datentyp LREAL.
Falls der anliegende Wert im gemeinsamen Wertbereich des Eingangsdatentyps und des Ergebniswerts LREAL liegt, so liefert der Baustein diesen Wert.
Abweichung von IEC-Norm
Die IEC-Norm definiert, dass die Konvertierung für die Datentypen, die laut der IEC-Norm vorgesehen sind, als Binär-Transfer erfolgt. Dieser Baustein weicht jedoch von der IEC-Norm ab. Die Werte des Datentyps LWORD werden abweichend von der IEC-Norm konvertiert . Das Verhalten in logi.CAD 3 ist so:
Ein Wert des Datentyps LWORD wird als Binär-Transfer auf ULINT zugewiesen (dies erfolgt bereits als Abweichung von der Norm).
Nach dieser Zuweisung wird der Wert des Datentyps ULINT in den Wert des Datentyps LREAL konvertiert. Diese Konvertierung erfolgt laut der IEC-Norm "Table 23 – Data type conversion of numeric data types", Zeile 55 "ULINT_TO_LREAL", "Conversion detail: Conversion with potential loss of accuracy". Dennoch ist diese Konvertierung ebenfalls eine Abweichung von der Konvertierung, die in der IEC-Norm "Table 25 – Data type conversion of bit and numeric types", Zeile 1 "LWORD_TO_LREAL", "Conversion detail: Binary transfer" vorgegeben ist.
Beachten Sie zusätzlich:
Falls ein anliegender Wert mit mehr als 15 Stellen konvertiert wird, kann das Ergebnis inexakt sein. Grund sind die Anzahl der signifikanten Stellen von LREAL (Details: siehe " Unterstützte Datentypen (in ST)" der Hinweis 3 und der Hinweis 4 nach der Tabelle ).
Falls ein Wert vom Datentyp STRING am Eingang anliegt, der einem gültiger Real-Literal entspricht (siehe die folgende Tabelle für Beispiele), wird der Wert entsprechend konvertiert. Der Ausgang ENO wird hier auf den Wert TRUE gesetzt.
Bei anderen Werten liefert der Baustein den Wert 0.0. Hier wird d er Ausgang ENO auf den Wert FALSE gesetzt. Sonderfall: Falls der anliegende Wert mit einem gültigen Real-Literal beginnt und dahinter andere Zeichen folgen (z.B. '3.14159_26', STRING#'1.5 E10', '-INFxxx'), liefert der Baustein den Anfangswerts, wie er unterstützt wird (also: 3.14159, 1.5, -INF) und der Ausgang ENO wird auf den Wert FALSE gesetzt.
Beschreibung
Beispiele für Werte vom Datentyp STRING, die einem gültigen Real-Literal entsprechen
Real-Literal
'0', '0.0', '0.4560', '3.1415926', '-123456789',STRING#'0', STRING#'0.0', STRING#'0.4560', STRING#'3.1415926', STRING#'-123456789'
Real-Literal mit Exponenten
'-1.34E-12', '-1.34e-12', '1.0E+6', '1.0e+6, 1E+6', '1.234E6', '1.234e6',STRING#'-1.34E-12', STRING#'-1.34e-12', STRING#'1.0E+6', STRING#'1.0e+6, STRING#1E+6', STRING#'1.234E6', STRING#'1.234e6',' 987e-3', ' +2.5E30',STRING#' 987e-3', STRING#' +2.5E30'
keine Zahl ("Not a Number") oder unendlich ("Infinity")
'Nan', 'INF', '-INF'
Real-Literale mit der Typangabe REAL bzw. LREAL sind keine gültigen Real-Literale.
Beispiel für Werte vom Datentyp STRING, die einem ungültigen Real-Literal entsprechen: 'REAL#0.0' bzw. 'LREAL#0.0'Falls ein Wert vom Datentyp CHAR am Eingang anliegt, der einem gültiger Real-Literal entspricht (z.B. '0', CHAR#'9'), wird der Wert entsprechend konvertiert (also: 0.0, 9.0). Der Ausgang ENO wird hier auf den Wert TRUE gesetzt.
Bei anderen Werten (z.B. '+', CHAR#A) liefert der Baustein den Wert 0.0. Hier wird der Ausgang ENO auf den Wert FALSE gesetzt.
Explizite Konvertierung laut IEC-Norm
Die IEC-Norm sieht eine explizite Konvertierung der folgenden Datentypen auf LREAL vor:
REAL, LINT, DINT, INT, SINT, ULINT, UDINT, UINT, USINT, LWORD
Die IEC-Norm (Edition 3.0) sieht eine binäre Übertragung aller Eingangsdatentypen vor . Abweichend davon wird der entsprechende Wert bei den folgenden Eingangsdatentypen aber laut IEC-Norm (Edition 2.0) konvertiert.
LWORD
Details zum logi.CAD 3 -Verhalten des Bausteins finden Sie im Abschnitt "Funktionalität".
Eingänge, Ergebniswert
|
Bezeichner |
Beschreibung |
|
Eingänge: |
IN |
REAL, LREAL, USINT, UINT, UDINT, ULINT, SINT, INT, DINT, LINT, TIME, BOOL, BYTE, WORD, DWORD, LWORD, STRING, CHAR oder TIME_OF_DAY |
zu konvertierender Wert |
Ergebniswert: |
– |
LREAL |
|
Der Eingang EN und der Ausgang ENO sind für den →Aufruf
des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN und zum Ausgang ENO.
Informieren Sie sich unter:
"Bausteine für sichere Logik", ob dieser Baustein für das Entwickeln von sicherheitsrelevanten Anwendungen unterstützt wird.
"Kennzeichnung von sicherer Logik im FBS-Editor", welche Auswirkung die Verwendung des Bausteins als Baustein für sichere Logik hat.
Interne Fehlerdiagnose für Baustein
Der Baustein prüft den Wert, der am Eingang anliegt. In den folgenden Fällen wird der Ausgang ENO des Bausteins auf den Wert FALSE (oder eine Entsprechung) zurückgesetzt:
Ein STRING-Wert enthält ein nicht-erlaubtes Zeichen oder beginnt damit. (Der Wert, den der Baustein liefert, ist von der Postion der nicht-erlaubten Zeichen abhängig. Siehe die Beschreibung unter "Funktionalität" oben.)
Der CHAR-Wert ist ein nicht-erlaubtes Zeichen. (In diesem Fall liefert der Baustein außerdem den Wert 0.0.)
Beispiel für Verwendung im ST-Editor
PROGRAM Test
VAR
result : LREAL;
END_VAR
result := TO_LREAL(IN := SINT#
12
); (* The variable
'result'
evaluates to value
'12.0'
of LREAL. *)
END_PROGRAM
Bei der Erstellung Ihrer Anwendung im ST-Editor erstellen Sie den Aufruf eines Bausteins, indem Sie den laut Syntax erforderlichen Text eintippen oder die Inhaltshilfe verwenden.