Kurz-Information

Name	`TO_STRING`
→POE-Typ	→Funktion
Kategorie	IEC-Baustein, ConvertEnh, Baustein mit interner Fehlerdiagnose
Konform zur →IEC-Norm	so nicht in IEC-Norm vorgesehen (siehe "Explizite Konvertierung laut IEC-Norm")
Grafische Schnittstelle
Verfügbar ab	Version 1.90.0 (für logi.CAD 3 )

Funktionalität

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

Falls der anliegende Wert im gemeinsamen Wertbereich des Eingangsdatentyps und des Ergebniswerts STRING liegt, so liefert der Baustein diesen Wert. Das Format hängt vom Eingangsdatentyp ab:

Eingangsdatentyp	Format des Ergebniswerts	String-Länge
`BOOL`	`TRUE` oder `FALSE`
`BYTE`, `WORD`, `DWORD`, `LWORDUSINT`, `UINT`, `UDINT`, `ULINTSINT`, `INT`, `DINT`, `LINT`	Dezimalwert	vorzeichenbehaftet (signed): maximale Länge `20` (z.B. '`-9223372036854775808')` vorzeichenlos (unsigned): maximale Länge `20` (z.B. '`18446744073709551615')`
`REAL`, `LREAL`	Gleitkomma- oder Exponentialwert	maximale Länge `25` (z.B. '`-1.1234567890123456e+1234')`
`CHAR`, `STRING`	wie Eingangswert	wie Eingangswert
`TIME` `T#[-][d][h][m][s][ms][us]`	`T#-xxxxxxxdxxhxxmxxsxxxmsxxxus` Zeitdauer-Einheiten (wie z.B. `d`) werden weggelassen, falls diese `0` sind.	Länge `30`
`TIME_OF_DAY` `TOD#[[-]xxxxd]hh:mm:ss[.us]`	`T#-xxxxxxxdHH:MM:SS.mmmuuu` Die Zeitdauer-Einheit `d` wird weggelassen, falls diese < `1` ist.	Länge `26`
`DATE`, sofern der Wert im möglichen Bereich liegt `DATE#YYYY-MM-DD`	`DATE#YYYY-MM-DD`	Länge `15`
`DATE`, sofern der Wert nicht im möglichen Bereich liegt `DATE#[-]xxxxd`	`T#-xxxxxxxd`	Länge `11`
`DATE_AND_TIME`, sofern der Wert im möglichen Bereich liegt `DT#YYYY-MM-DD-hh:mm:ss[.us]`	`DT#YYYY-MM-DD-HH:MM:SS.mmmuuu`	Länge `29`
`DATE_AND_TIME`, sofern der Wert nicht im möglichen Bereich liegt `DT#[-]xxxxd-hh:mm:ss[.us]`	`DT#-xxxxxxxd-HH:MM:SS.mmmuuu`	Länge `28`

Hinweis: Das Format YYYY-MM-DD ist nur im Bereich 1970-01-01 bis 2038-01-19 möglich (0 - 24.855 Tage, 0 - 2.147.483.647 Sekunden).

Explizite Konvertierung laut IEC-Norm

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

WSTRING

Der Datentyp WSTRING wird derzeit von logi.CAD 3 nicht unterstützt.

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`, `DATE_AND_TIME`, `DATE` oder `TIME_OF_DAY`	zu konvertierender Wert
Ergebniswert:	–	`STRING`

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.

Interne Fehlerdiagnose für Baustein

Der Baustein prüft vor der Ausführung den Datentyp des an IN anliegenden Werts bzw. den Ergebniswert. Falls der Ergebniswert im zur Verfügung stehenden Speicher nicht abgebildet werden kann (der Ergebniswert ist zu groß), wird der Ausgang ENO des Bausteins auf den Wert FALSE (oder eine Entsprechung) gesetzt.

Beispiel für Verwendung im ST-Editor

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

FUNCTION_BLOCK ExampleToString
   VAR
      result : STRING[5];
   END_VAR
   result := TO_STRING(IN := SINT#12);
  
   Assert(result = STRING#'12');
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.