Kurz-Information

Name	`TO_INT`
→POE-Typ	→Funktion
Kategorie	IEC-Baustein, Convert, Baustein mit interner Fehlerdiagnose
Konform zur →IEC-Norm	i mplementierungsabhängige Realisierung; siehe "Funktionalität" und mehr als in IEC-Norm vorgesehen möglich; siehe "Explizite Konvertierung laut IEC-Norm"
Grafische Schnittstelle
Verfügbar ab	Version 1.0.0 (für logi.CAD 3) – Anfangsvariante Version 1.90.0 (für logi.CAD 3) – Erweiterung: `TIME_OF_DAY` für `IN` Version 2.0.15 (für Bibliothek `Standard`) – Erweiterung: `STRING` für `IN` ohne Zeichen _, interne Fehlerdiagnose Version 2.0.16 (für Bibliothek `Standard`) – Erweiterung: `STRING` für `IN` mit Zeichen `_` Version 2.0.17 (für Bibliothek `Standard`) – Erweiterung: `CHAR` für `IN` Version 3.1.0 (für Bibliothek `Standard`) – Für Eingänge vom Datentyp `REAL` wird die optimierte `float` - Variante der C-Runtime verwendet. Im Vergleich zu früheren Versionen können i n den Grenzwertbereichen des Bausteins (geringfügig) andere Ergebnisse geliefert werden.

Funktionalität

Der Baustein dient zur expliziten Konvertierung des an IN anliegenden Werts in einen Wert vom Datentyp INT.

Falls der anliegende Wert im gemeinsamen Wertbereich des Eingangsdatentyps und des Ergebniswerts INT liegt, so liefert der Baustein diesen Wert.

Implementierungsabhängige Realisierung

Die IEC-Norm definiert, dass es ein Fehler ist, wenn der anliegende Wert nicht im gemeinsamen Wertbereich des Eingangsdatentyps und des Datentyps des Ergebniswerts liegt, aber auch dass es sich dabei um ein implementiererspezifisches Verhalten handelt. In logi.CAD 3 verhalten sich die Konvertierungsbausteine prinzipiell so: Der nicht-übereinstimmende Wertbereich wird nicht als ein Fehler betrachtet. Zusätzlich gilt:

Falls ein Wert von einem Datentyp anliegt, bei dem es sich nicht um REAL oder LREAL handelt: Die höherwertigen Stellen (= jene Stellen, die nicht im gemeinsamen Wertbereich liegen) werden abgeschnitten.
Falls ein Wert vom Datentyp REAL oder LREAL anliegt: Der Ergebniswert des Bausteins ist vom Compiler und Zielsystem abhängig (siehe "Auswirkungen der Compiler-Einstellungen auf die Ausführung" für Details).

Beachten Sie zusätzlich:

Bei der Umwandlung von Datentypen auf den TIME-Datentyp und umgekehrt wird immer auf Sekunden-Basis konvertiert.

Falls ein Wert vom Datentyp STRING am Eingang anliegt, wird der Wert in einen Dezimalwert (Basis: 10, erlaubte Ziffern: 0 bis 9) konvertiert und dann wird dieser Dezimalwert in einen Wert des Ziel-Datentyps konvertiert. Diese Spezialfälle sind dabei möglich (siehe unter " Beispiel für Verwendung im ST-Editor" ) :

Falls der Wert mit dem Zeichen + , mit Leerzeichen oder Tabulatoren (= sogenannten "Whitespace") beginnt und falls der Wert innerhalb des Wertbereichs des Ziel-Datentyps liegt, wird der Wert in einen positiven Dezimalwert (wie ohne diese Zeichen) konvertiert. Der Ausgang ENO wird hier auf den Wert TRUE gesetzt.
Details zu dieser Konvertierung: Ein dem Wert vorangestelltes Zeichen + wird ignoriert , ebenso werden Leerzeichen und Tabulatoren ignoriert.
Falls der Wert mit dem Zeichen – beginnt und der Wert innerhalb des Wertbereichs des Ziel-Datentyps liegt, wird der Wert in einen negativen Dezimalwert konvertiert. Auch hier wird d er Ausgang ENO auf den Wert TRUE gesetzt.

Falls der Wert ein nicht erlaubtes Zeichen enthält, liefert der Baustein den Wert 0. Hier wird der Ausgang ENO auf den Wert FALSE gesetzt.

Erlaubte Zeichen	Nicht erlaubte Zeichen
Ziffern (Basis: 10, Zahlen: `0` bis `9`) Beispiel für Wert mit erlaubtem Zeichen: `'12'`	andere Zeichen, wie z.B. Buchstaben Beispiele für Wert mit nicht erlaubtem Zeichen: `'12a3'`, `'a123'`
ein dem Wert vorangestelltes Zeichen `+` oder `–` Beispiel für Wert mit erlaubtem Zeichen: `+2` oder `–3`	Wiederholungen von `+` oder `–` am Anfang des Werts, das Zeichen `+` oder `–` innerhalb des Werts Beispiele für Wert mit nicht erlaubtem Zeichen: `'++1'`, `'1–3'`
einzelne Unterstrich-Zeichen _ innerhalb des Werts Beispiel für Wert mit erlaubtem Zeichen: `1_2` oder `1_2_3`	Unterstrich-Zeichen _ am Anfang oder Ende des Werts, mehrere Unterstrich-Zeichen _ direkt hintereinander Beispiel für Wert mit nicht erlaubtem Zeichen: `_12`, `12_` oder `1__2`

Falls der zu konvertierende STRING-Wert die Obergrenze des Ziel-Datentyps übersteigt, liefert der Baustein die Obergrenze des Ziel-Datentyps. Auch h ier wird der Ausgang ENO auf den Wert FALSE gesetzt.
Falls der zu konvertierende STRING-Wert unter der Untergrenze des Ziel-Datentyps liegt, liefert der Baustein die Untergrenze des Ziel-Datentyps. Auch h ier wird der Ausgang ENO auf den Wert FALSE gesetzt.

Falls ein Wert vom Datentyp CHAR am Eingang anliegt, erfolgt die Konvertierung analog zu einem STRING-Wert. Als Unterschied zur STRING-Konvertierung sind bei der CHAR-Konvertierung nur die einzelnen Ziffern 0 bis 9 erlaubt. Für alle anderen Zeichen (Buchstaben, die Zeichen +, - und _) liefert der Baustein den Wert 0 und der Ausgang ENO wird auf den Wert FALSE gesetzt.

Explizite Konvertierung laut IEC-Norm

Die IEC-Norm sieht eine explizite Konvertierung der folgenden Datentypen auf INT vor:

LREAL, REAL, LINT, DINT, SINT, ULINT, UDINT, UINT, USINT, LWORD, DWORD, WORD, BYTE, BOOL

Eingänge, Ergebniswert

	Bezeichner	→Datentyp	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:	–	`INT`

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. (In diesem Fall liefert der Baustein außerdem den Wert 0.)
Ein STRING-Wert übersteigt die Obergrenze des Ziel-Datentyps. (In diesem Fall liefert der Baustein außerdem die Obergrenze des Ziel-Datentyps.)

Ein STRING-Wert unterschreitet die Untergrenze des Ziel-Datentyps. (In diesem Fall liefert der Baustein außerdem die Untergrenze des Ziel-Datentyps.)

Der CHAR-Wert ist ein nicht erlaubtes Zeichen. (In diesem Fall liefert der Baustein außerdem den Wert 0.)

Beispiel für Verwendung im ST-Editor

Die berechneten Werte werden mit Hilfe des Assert-Bausteins ausgewertet.

Beispiel für DINT-Wert

FUNCTION_BLOCK ExampleToInt
  VAR
   result : INT; 
  END_VAR
 
  result := TO_INT(IN := SINT#12);
  Assert(result = 12);
  
END_FUNCTION_BLOCK

Beispiel für STRING-Werte

FUNCTION_BLOCK ExampleToIntString
  VAR
   resultStr1, resultStr2, resultStr3, resultStr4, resultStr5, resultStr6, resultStr7, resultStr8, resultStr9, resultStr10, resultStr11, resultStr12, resultStr13, resultStr14, resultStr15 : INT;
   CheckENO1, CheckENO2, CheckENO3, CheckENO4, CheckENO5, CheckENO6, CheckENO7, CheckENO8, CheckENO9, CheckENO10, CheckENO11, CheckENO12, CheckENO13, CheckENO14, CheckENO15 : BOOL;
  END_VAR
   
  resultStr1 := TO_INT(IN:='12', ENO=>CheckENO1);
  Assert(resultStr1 = 12);
  Assert(CheckENO1 = TRUE);
     
  resultStr2 := TO_INT(IN:='    3', ENO=>CheckENO2);
  Assert(resultStr2 = 3);
  Assert(CheckENO2 = TRUE);
   
  resultStr3 := TO_INT(IN:='+2', ENO=>CheckENO3);
  Assert(resultStr3 = 2);
  Assert(CheckENO3 = TRUE);
  
  resultStr4 := TO_INT(IN:='-3', ENO=>CheckENO4);
  Assert(resultStr4 = -3);
  Assert(CheckENO4 = TRUE);
   
  resultStr5 := TO_INT(IN:='1_2', ENO=>CheckENO5);
  Assert(resultStr5 = 12);
  Assert(CheckENO5 = TRUE);
  
  resultStr6 := TO_INT(IN:='1_2_3', ENO=>CheckENO6);
  Assert(resultStr6 = 123);
  Assert(CheckENO6 = TRUE);
  
  resultStr7 := TO_INT(IN:='123a45', ENO=>CheckENO7);
  Assert(resultStr7 = 0);
  Assert(CheckENO7 = FALSE);
   
  resultStr8 := TO_INT(IN:='a1234', ENO=>CheckENO8);
  Assert(resultStr8 = 0);
  Assert(CheckENO9 = FALSE);
   
  resultStr9 := TO_INT(IN:='++1', ENO=>CheckENO9);
  Assert(resultStr9 = 0);
  Assert(CheckENO9 = FALSE);
   
  resultStr10 := TO_INT(IN:='1-3', ENO=>CheckENO10);
  Assert(resultStr10 = 0);
  Assert(CheckENO10 = FALSE);
  
  resultStr11 := TO_INT(IN:='_12', ENO=>CheckENO11);
  Assert(resultStr11 = 0);
  Assert(CheckENO11 = FALSE);
  
  resultStr12 := TO_INT(IN:='12_', ENO=>CheckENO12);
  Assert(resultStr12 = 0);
  Assert(CheckENO12 = FALSE);
  
  resultStr13 := TO_INT(IN:='1__2', ENO=>CheckENO13);
  Assert(resultStr13 = 0);
  Assert(CheckENO13 = FALSE);
   
  resultStr14 := TO_INT(IN:='35000', ENO=>CheckENO14);   (* The upper limit for INT is 32_767. *)
  Assert(resultStr14 = 32_767);
  Assert(CheckENO14 = FALSE);
   
  resultStr15 := TO_INT(IN:='-35000', ENO=>CheckENO15);   (* The lower  limit for INT is -32_768. *)
  Assert(resultStr15 = -32_768);
  Assert(CheckENO15 = FALSE);
      
END_FUNCTION_BLOCK

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.