• Home
• Funktionen/Funktionsbausteine - Referenz
• IEC 61131-3 Funktionen und Funktionsbausteine
• Funktionen zur Typumwandlung (Konvertierung)
• TO_ULINT

TO_ULINT

Typ	Funktion
Beschreibung	Die überladene Funktion TO_ULINT konvertiert den am Eingang anliegenden Wert in einen Ausgangswert des Datentyps ULINT (siehe Beschreibung des Eingangs für die unterstützten Datentypen).
Parameter	Eingang IN Datentyp: Die Funktion unterstützt folgende Datentypen: BOOL, BYTE, WORD, DWORD, LWORD Integer: SINT, INT, DINT, LINT, USINT, UDINT, UINT Gleitkommazahlen: REAL, LREAL STRING, WSTRING Ausgang OUT Datentyp: ULINT
Konvertierungsregeln	ANY_BIT-Konvertierung Die Konvertierung erfolgt durch bitweises Kopieren des Eingangswerts in den Ausgangswert, d.h. es erfolgt eine binäre Übertragung vom Eingangsdatentyp in den Ausgangsdatentyp. Nicht verwendete Bits im Ausgangsdatentyp werden auf 0 gesetzt. ANY_INT-Konvertierung Für die Datentypkonvertierung gilt folgendes: Der Quelldatentyp wird auf den größten Datentyp derselben Kategorie von Datentypen erweitert. Beispiel: ein USINT-Wert wird in einen ULINT-Wert konvertiert oder ein SINT-Wert in einen LINT-Wert). Der Quellwert bleibt dabei erhalten. Das Ergebnis wird auf den größten Datentyp der Kategorie von generischen Datentypen konvertiert, zu der der Zieldatentyp gehört. Beispiel: ein LINT-Wert wird bei einer ANY_UNSIGNED-Konvertierung in einen ULINT-Wert konvertiert. Das Ergebnis wird zum Zieldatentyp konvertiert. Eingangsgröße <= Ausgangsgröße: Ist der Eingangsdatentyp kleiner oder gleich groß wie der Zieldatentyp ist, werden alle Bits in den Ausgangswert kopiert. Bei einem Eingangswert vom Typ ANY_UNSIGNED (Ganzzahl ohne Vorzeichen), werden die "nicht verwendeten" Bits im Zieldatentyp auf 0 gesetzt. Bei einem Eingangswert vom Typ ANY_SIGNED (Ganzzahl mit Vorzeichen) wird das höchstwertige Bit (MSB) nicht weiter als Vorzeichenbit interpretiert. Eingangsgröße > Ausgangsgröße: Wenn der Wert der Quellvariable nicht in den Zieldatentyp passt, werden nur die Bits des Eingangswerts in den Zieldatentyp kopiert, die in den Zieldatentyp passen. Beispiel: bei einer TO_UDINT-Konvertierung werden nur die Bits 0 bis 31 des Eingangswerts in die Zielvariable kopiert und bei einer TO_USINT-Konvertierung nur die Bits 0 bis 7. Beispiel: out := TO_ULINT(INT#-5); Der INT-Wert INT# -5 wird in den LINT-Wert LINT# -5 konvertiert. Der LINT-Wert LINT#-5 wird in den ULINT-Wert ULINT#18446744073709551611 konvertiert. Der letzte Schritt ist nicht notwendig, da der Ausgangswert bereits vom Datentyp ULINT ist. ANY_REAL-Konvertierung Die Typkonvertierung erfolgt in zwei Schritten. Zuerst wird die Gleitkommazahl auf die nächst größere ganze Zahl gemäß den Standard-Rundungsregeln gerundet (Bsp.: 2,5 wird auf 3 aufgerundet und -2,5 auf -3). Im zweiten Schritt wird der gerundete Eingangswert in die niederwertigsten Bits des Ausgangswerts geschrieben. ANY_REAL-Konvertierung Die Typkonvertierung erfolgt in zwei Schritten. Zuerst wird die Gleitkommazahl auf die nächst größere ganze Zahl gemäß den Standard-Rundungsregeln gerundet (Bsp.: 2,5 wird auf 3 aufgerundet und -2,5 auf -3). Im zweiten Schritt wird der gerundete Eingangswert in die niederwertigsten Bits des Ausgangswerts geschrieben. Hinweis Aufgrund des Signifikanzverlustes von REAL-Werten sollten nur REAL-Werte kleiner als ULINT_MAX angelegt werden. ANY_STRING-Konvertierung Der String-Wert muss ein gültiges numerisches Literal des Ausgangsdatentyps sein. Andernfalls liefert die Funktion den Wert 0 zurück und der Laufzeitfehler 'Formatstringfehler' wird ausgegeben (siehe Hinweis unten). Zusätzliche Zeichen, Leerzeichen ausgenommen, vor und nach dem numerischen Literal sind nicht erlaubt. Die Funktion liefert den Wert 0 zurück und gibt den Laufzeitfehler 'Formatstringfehler' aus, wenn der String-Wert nicht erlaubte Zeichen enthält. Alle führenden und nachfolgenden Leerzeichen im Eingangsstring werden ignoriert. Als Leerzeichen betrachtete ASCII-Codes: Zeichen Wert Horizontal-Tabulator 9 (09h) Zeilenvorschub 10 (0Ah) Vertikal-Tabulator 11 (0Bh) Seitenvorschub 12 (0Ch) Zeilenumbruch 13 (0Dh) Leerzeichen 32 (20h) Wenn der Eingangswert den Wertebereich des Ausgangsdatentyps überschreitet, liefert die Funktion den Überlaufwert und der Laufzeitfehler 'Formatstringfehler' wird ausgegeben (siehe Hinweis unten). Binäre, oktale, hexadezimale und dezimale Ganzzahlen sind erlaubt. Beispiel: INT#2#0101 (binäre Darstellung des Werts 5) INT#8#606 (oktale Darstellung des Werts 390) INT#10#100 (dezimale Darstellung des Werts 100) INT#16#00FA (hexadezimale Darstellung des Werts 250) Hinweis Steuerungstopp bei String-Fehler: Sie können einstellen, ob die Steuerung bei einem String-Fehler automatisch gestoppt werden soll. Dies gibt Ihnen im Fehlerfall die Möglichkeit, den Fehler in Ihrem Projekt zu lokalisieren. Um bei einem String-Fehler die Steuerung automatisch zu stoppen, aktivieren Sie das Symbol in der Symbolleiste des Cockpits.   Hinweis: Wenn sowohl der Wertebereich als auch die Genauigkeit des Eingangsdatentyps auf den Wertebereich und die Genauigkeit des Ausgangsdatentyps übertragen (gemappt) werden können, so kann ohne Verwendung dieser Funktion eine implizite Typkonvertierung durchgeführt werden. Bei der Funktion TO_ULINT trifft dies auf Eingangswerte vom Datentyp UDINT, UINT und USINT zu.
Fehlerverhalten	Fehlerverhalten Die folgende Tabelle zeigt die Fehler, die bei der Ausführung der Funktion auftreten können, und den von der Funktion im entsprechenden Fehlerfall zurückgegebenen Wert. Fehlerfall Ausgabewert RFC/NFC/AXC F 3152 Ausgabewert AXC F 2152 Überlaufwert (Siehe den Hinweis für große Real-Werte im Anschluss an die Tabelle.) Überlaufwert Überlaufwert REAL/LREAL-Wert >= LINT_MAX LINT_MAX + 1 REAL/LREAL-Wert Hinweis ENO bleibt TRUE. REAL/LREAL-Wert <= LINT_MIN LINT_MAX + 1 REAL/LREAL Überlauf REAL/LREAL-Wert > ULINT_MAX LINT_MAX + 1 ULINT_MAX REAL/LREAL-Wert > -ULINT_MAX LINT_MAX + 1 1 REAL/LREAL: NaN LINT_MAX + 1 0 REAL/LREAL: Inf+ LINT_MAX + 1 ULINT_MAX REAL/LREAL: Inf- LINT_MAX + 1 1 Nicht-literaler String 0 0 String-Überlauf Überlaufwert Überlaufwert Tritt einer der aufgeführten String-Fehler auf, wird ein String-Fehler im Online-Protokoll des MELDUNGEN-Fensters ausgegeben. Hinweis zu großen Real-Werten Oft ergibt der Überlauf den Wert 0 oder das Ergebnis hat Lücken. Der Grund dafür liegt in den Eigenschaften von Real-Zahlen, die nur eine bestimmte Anzahl signifikanter Ziffern haben. Bei REAL sind es nur 7 signifikante Werte. Je größer die Zahl ist, desto größer ist die Wahrscheinlichkeit, dass das Ergebnis 0 ist (insbesondere bei kleinen Ausgangstypen). Beispiel: 3.6000000E+7 => 3.600000E+7 => SINT: 0 3.6000001E+7 => 3.600000E+7 => SINT: 0 3.6000002E+7 => 3.600000E+7 => SINT: 0 3.6000003E+7 => 3.600004E+7 => SINT: 4 3.6000004E+7 => 3.600004E+7 => SINT: 4 ... Die Werte 3.600001E+7, 3.600002E+7 und 3.600003E+7 können nicht als REAL-Werte dargestellt werden und werden deshalb auf den nächstmöglichen REAL-Wert gesetzt. Das führt zu Lücken. Je größer die Zahl ist, desto größer wird die Lücke, solange bis immer 0 als Ergebnis angezeigt wird.
Beispiele	Beispiele in ST out := TO_ULINT(16#7F);   (* liefert 127 *) out := TO_ULINT(16#FFFFFFFF);   (* liefert 4.294.967.295 *) out := TO_ULINT(SINT#-128);   (* liefert 128 *) out := TO_ULINT(LINT#-9223372036854775808);   (* liefert 9.223.372.036.854.775.808 *) out := TO_ULINT('123');   (* liefert 123 *)
Zusätzliche Informationen	EN/ENO-Verhalten Die POE wird nur dann ausgeführt, wenn TRUE am Eingang EN anliegt. Wenn EN = FALSE ist, wird die POE nicht ausgeführt und ENO auf FALSE gesetzt (FU/FB inaktiv). Wenn bei der Ausführung der Funktion einer der unter "Fehlerverhalten" aufgeführten Fehler auftritt, wird ENO auf FALSE gesetzt. Weitere Infos Weitere Informationen finden Sie im Thema "Allgemeine Informationen zur Ausführungssteuerung mit EN/ENO".