DINT_TO_DECSTR

Die Funktion konvertiert eine vorzeichenbehaftete Dezimalzahl in einen Dezimalstring (Basis 10).

Rückgabewert

Name	Typ	Beschreibung
DINT_TO_DECSTR	T_MaxString

Eingänge

VAR_INPUT
    in         : DINT;
    iPrecision : INT;
END_VAR

Name	Typ	Beschreibung
in	DINT	Die zu konvertierende Dezimalzahl.
iPrecision	INT	Minimale Anzahl der erscheinenden Stellen (digits). Ist die tatsächliche Anzahl der signifikanten Stellen kleiner als der iPrecision-Parameter, dann wird der resultierende String links mit Nullen aufgefüllt. Ist die Anzahl der signifikanten Stellen größer ist als der iPrecision-Parameter, dann wird der resultierende String nicht abgeschnitten! Hat der iPrecision-Parameter und der in-Parameter den Wert Null, dann ist der resultierende String ein Leerstring. Bei negativen Zahlen erscheint im resultierenden String zusätzlich das negative Vorzeichen.

Beispiel:

PROGRAM MAIN
VAR
    s1   : STRING;
    s2   : STRING;
    s3   : STRING;
    s4   : STRING;
    iCnt : INT;
END_VAR

iCnt := -1234;
s1   := DINT_TO_DECSTR( iCnt, 1);
s2   := DINT_TO_DECSTR( iCnt, 10 );
iCnt := 0;
s3   := DINT_TO_DECSTR( iCnt, 0 );
iCnt := 1234;
s4   := DINT_TO_DECSTR( iCnt, 10 );

Das Ergebnis:

s1 = '-1234'

s2 = '-0000001234'

s3 = ''

s4 = '0000001234'

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.0	PC oder CX (x86, x64, Arm^®)	Tc2_Utilities (System)