Twido-Funktionen

 

Twido-Funktionen

Überblick

Die folgende Liste bietet einen Überblick über die Twido-Funktionen:

oFC_AsciiCharToInt

oFC_AsciiToInt

oFC_AsciiToReal

oFC_ConcatOfInt

oFC_CopyArrDint

oFC_CopyArrInt

oFC_CopyArrReal

oFC_CopyBitString

oFC_CopyPackedBitString

oFC_DegToRad

oFC_EqualArrDint

oFC_EqualArrReal

oFC_FindEqDint

oFC_FindEqReal

oFC_FindGtDint

oFC_FindGtReal

oFC_FindLtDint

oFC_FindLtReal

oFC_HiOfDint

oFC_IntToAscii

oFC_Lkup

oFC_LoOfDint

oFC_MaxArrDint

oFC_MaxArrReal

oFC_MeanArrReal

oFC_MinArrDint

oFC_MinArrReal

oFC_MoveArrDint

oFC_MoveArrInt

oFC_MoveArrReal

oFC_OccurArrDint

oFC_OccurArrReal

oFC_RadToDeg

oFC_RealToAscii

oFC_RolArrDint

oFC_RolArrReal

oFC_RorArrDint

oFC_RorArrReal

oFC_Round

oFC_SortArrDint

oFC_SortArrReal

oFC_SumArrDint

oFC_SumArrReal

FC_AsciiCharToInt

Diese Funktion gibt die 2 Zeichen als ganzzahlige Werte wieder.

Wenn die Zeichenfolge ungültig ist, wird die globale Variable G_xSystemBitS18 auf TRUE gesetzt.

FC_AsciiToInt

Mit der ASCII-Ganzzahl-Funktion werden ASCII-Zeichenfolgen in die entsprechenden Ganzzahlwerte konvertiert.

Die Anweisungsregeln zur Konvertierung von ASCII in Ganzzahlen lauten wie folgt:

oDer ASCII -Wert muss im Bereich von -32768 bis 32767 enthalten sein.

oDie Funktion liest immer zuerst das höherwertige Byte.

oJedes ASCII-Zeichen, das außerhalb des Bereichs [0...9] ([30 hex - 39 hex]) liegt, wird als Endzeichen betrachtet, es sei denn, es handelt sich um Minuszeichen '-' (2D hex), das an erster Stelle steht.

oBei einem Überlauf (>32767 oder <-32768) wird die globale Variable G_xSystemBitS18 (arithmetischer Überlauf oder Fehler) auf 1 gesetzt und der Wert 32767 oder -32768 zurückgegeben.

oWenn das erste Zeichen des Operanden ein Endzeichen ist, wird der Wert 0 zurückgegeben und die globale Variable G_xSystemBitS18 auf TRUE gesetzt.

FC_AsciiToReal

Mit der ASCII-REAL-Funktion werden ASCII-Zeichenfolgen in die entsprechenden REAL-Werte konvertiert.

Für die Konvertierung von ASCII in REAL gelten folgende Regeln:

oDie Funktion liest zuerst das höherwertige Byte.

oJedes ASCII-Zeichen, das sich nicht im Bereich [0...9] ([30 hex - 39 hex]) befindet, wird als „Ende“-Zeichen betrachtet, mit Ausnahme von:

oDezimalpunkt '.' (2E hex)

oMinus '-' (2D hex)

oPlus '+' (2B hex)

oExponent 'e' oder 'E' (65 hex bzw. 45 hex)

oDas Zeichenfolgenformat ASCII kann exponentiell (als „-2.34567e+13“) oder dezimal (als 9826.3457) dargestellt werden.

oBei Überlauf (Berechnungsergebnis ist > 3.402824E+38 oder < -3.402824E+38):

oDie globale Variable G_xSystemBitS18 (arithmetischer Überlauf oder festgestellter Fehler) wird auf TRUE gesetzt.

oDer Wert +/- 1.#INF (+ oder - unendlicher Wert) wird zurückgegeben.

oWenn das Berechnungsergebnis zwischen -1.175494E-38 und 1.175494E-38 liegt, dann wird das Ergebnis auf 0,0 gerundet.

oWenn der Operand keine Zahl ist, wird der Wert 1.#QNAN zurückgegeben und die globale Variable G_xSystemBitS18 auf TRUE gesetzt.

FC_ConcatOfInt

Mit dieser Funktion werden zwei Ganzzahlen zu einer doppelten Ganzzahl verkettet.

FC_CopyArrDint

Mit dieser Funktion wird ein Array von DINT-Werten an eine andere gegebene Speicheradresse kopiert.

FC_CopyArrInt

Mit dieser Funktion wird ein Array von INT-Werten an eine andere gegebene Speicheradresse kopiert.

FC_CopyArrReal

Mit dieser Funktion wird ein Array von REAL-Werten an eine andere gegebene Speicheradresse kopiert.

FC_CopyBitString

Mit dieser Funktion wird ein Array von BOOL-Werten an eine andere gegebene Speicheradresse kopiert.

FC_CopyPackedBitString

Mit dieser Funktion wird eine gebündelte BitString mit einer Länge von i_bySize Bit an einen anderen Speicherort kopiert.

FC_DegToRad

Die Funktion FC_DegToRad konvertiert einen in Grad ausgedrückten Winkel in Radianten.

Verwendungsregeln:

Der zu konvertierende Winkel muss zwischen -737280,0 und +737280,0 liegen.

Für Werte außerhalb dieses Bereichs wird das Ergebnis + 1.#QNAN und die globale Variable G_xSystemBitS18 auf TRUE gesetzt.

FC_EqualArrDint

Mit der Funktion FC_EqualArrDint werden zwei Tabellen definierter Größe elementweise verglichen. Bei Abweichungen wird der Rang des ersten ungleichen Elements als Ganzzahl zurückgegeben. Gibt es keine Abweichungen, wird der Wert -1 zurückgegeben.

Die Startadressen der beiden zu vergleichenden Arrays werden an den beiden POINTER-Eingangsvariablen angegeben.

Die Anzahl der zu vergleichenden Elemente muss an der Eingangsvariablen i_bySize definiert werden.

FC_EqualArrReal

Mit der Funktion FC_EqualArrReal werden zwei Tabellen definierter Größe elementweise verglichen. Bei Abweichungen wird der Rang des ersten ungleichen Elements als Ganzzahl zurückgegeben. Gibt es keine Abweichungen, wird der Wert -1 zurückgegeben.

Die Startadressen der beiden zu vergleichenden Arrays werden an den beiden POINTER-Eingangsvariablen angegeben.

Die Anzahl der zu vergleichenden Elemente muss an der Eingangsvariablen i_bySize definiert werden.

FC_FindEqDint

Mit der Funktion FC_FindEqDint wird eine Reihe gegebener DINT-Werte nach der Position des ersten Array-Elements durchsucht, das einem bestimmten Wert entspricht.

Falls der angegebene Wert nicht in dem Array enthalten ist, wird -1 zurückgegeben.

FC_FindEqReal

Mit der Funktion FC_FindEqReal wird eine Reihe gegebener REAL-Werte nach der Position des ersten Array-Elements durchsucht, das einem bestimmten benutzerdefinierten Wert entspricht.

Falls der angegebene Wert nicht in dem Array enthalten ist, wird -1 zurückgegeben.

FC_FindGtDint

Mit der Funktion FC_FindGtDint wird eine Reihe gegebener DINT-Werte nach der Position des ersten Array-Elements durchsucht, das größer als ein bestimmter benutzerdefinierter Wert ist.

Falls kein Element in dem Array größer als der angegebene Wert ist, wird -1 zurückgegeben.

FC_FindGtReal

Mit der Funktion FC_FindGtReal wird eine Reihe gegebener REAL-Werte nach der Position des ersten Array-Elements durchsucht, das größer als ein bestimmter benutzerdefinierter Wert ist.

Falls kein Element in dem Array größer als der angegebene Wert ist, wird -1 zurückgegeben.

FC_FindLtDint

Mit der Funktion FC_FindLtDint wird eine Reihe gegebener DINT-Werte nach der Position des ersten Array-Elements durchsucht, das kleiner als ein bestimmter benutzerdefinierter Wert ist.

Falls kein Element in dem Array größer als der angegebene Wert ist, wird -1 zurückgegeben.

FC_FindLtReal

Mit der Funktion FC_FindLtReal wird eine Reihe gegebener REAL-Werte nach der Position des ersten Array-Elements durchsucht, das kleiner als ein bestimmter benutzerdefinierter Wert ist.

Falls kein Element in dem Array größer als der angegebene Wert ist, wird -1 zurückgegeben.

FC_HiOfDint

Mit dieser Funktion werden die höherwertigen Bits (MSB) einer doppelten Ganzzahl in eine Ganzzahl extrahiert.

FC_IntToAscii

Mit der Ganzzahl-ASCII-Funktion werden Ganzzahlen in die entsprechenden ASCII-Zeichenfolgen konvertiert.

Für die Konvertierung von Ganzzahlen in ASCII gelten folgende Regeln:

oDer Ganzzahlwert muss im Bereich von -32768 bis 32767 enthalten sein.

oDie Funktion schreibt immer zuerst das höherwertige Byte.

oDas Endzeichen ist ein Wagenrücklauf (ASCII 13).

oDie Funktion ermittelt automatisch, wie viele %MW-Variablen mit ASCII-Werten belegt werden sollten (von 1 bis 4).

FC_Lkup

Mit der Funktion FC_Lkup wird eine Reihe von X-Gleitkommadaten mit einer Reihe von Y-Gleitkommadaten für einen bestimmten X-Wert interpoliert.

Für den Eingangswert i_prSartAddr gelten folgende Bedingungen:

ogerade Anzahl von Werten

omindestens sechs Werte

oerstes Element ist gesuchter Wert x

ozweites Element wird von der Funktion gesetzt: Interpolationsergebnis

oalle folgenden Elemente sind interpolationsunterstützende Punkte in Paaren von X und Y

Interpolationsregeln:

Die Funktion LKUP verwendet die lineare Interpolationsregel wie in folgender Gleichung definiert:

 

 

Für X_i  ≤ X  ≤  X_i + 1, wobei i = 1 … (m-1)

Voraussetzung: X_i-Werte werden in aufsteigender Reihenfolge nach Rang sortiert: X₁ ≤ X₂ ≤ ...X...≤ X_m-1 ≤ X_m

Wenn zwei aufeinanderfolgende X_i-Werte gleich sind (X_i=X_i+1=X), führt Gleichung 1 zu einer ungültigen Ausnahme. Zur Behandlung dieser Ausnahmen wird statt Gleichung 1 der folgende Algorithmus verwendet:

 

 

Für X_i = X_i+1 = X, wobei i = 1…(m-1).

Ergebniswert:

Am Ergebniswert ist zu erkennen, ob die Interpolation erfolgreich war oder nicht.

0: erfolgreiche Interpolation

1: Interpolationsfehler: ungültiges Array, Xm < Xm-1

2: Interpolationsfehler: i_rXValue außerhalb des Bereichs, X < X1

4: Interpolationsfehler: i_rXValue außerhalb des Bereichs, X > Xm

8: Datenarray weist ungültige Größe auf: i_prYValue ist eine ungerade Zahl oder i_prYValue < 6

Der Ergebniswert enthält nicht den berechneten Interpolationswert (Y). Für einen vorgegebenen Wert (X) ist das Ergebnis der Interpolation (Y) in i_prYValue enthalten.

i_rXValue ist die Gleitkommavariable, die den benutzerdefinierten Wert (X) enthält, für den der interpolierte Wert (Y) berechnet wird.

Der gültige Bereich für i_rXValue lautet:

X₁ ≤  i_rXValue  ≤ X_m

FC_LoOfDint

Mit dieser Funktion werden die niederwertigen Bits (LSB) einer doppelten Ganzzahl in eine Ganzzahl extrahiert.

FC_MaxArrDint

Mit dieser Funktion wird eine Reihe gegebener DINT-Werte nach dem Höchstwert durchsucht. Die Suche wird nur innerhalb der definierten Tabellenlänge ausgeführt.

FC_MaxArrReal

Mit dieser Funktion wird eine Reihe gegebener REAL-Werte nach dem Höchstwert durchsucht. Die Suche wird nur innerhalb der definierten Tabellenlänge ausgeführt.

FC_MeanArrReal

Mit dieser Funktion wird in einer Reihe gegebener REAL-Daten der Mittelwert für die gewünschte Länge der REAL-Wertetabelle berechnet.

FC_MinArrDint

Mit dieser Funktion wird eine Reihe gegebener DINT-Werte nach dem Mindestwert durchsucht. Die Suche wird nur innerhalb der definierten Tabellenlänge ausgeführt.

FC_MinArrReal

Mit dieser Funktion wird eine Reihe gegebener REAL-Werte nach dem Mindestwert durchsucht. Die Suche wird nur innerhalb der definierten Tabellenlänge ausgeführt.

FC_MoveArrDint

Mit dieser Funktion wird der Eingangswert in der DINT-Wertetabelle für eine Reihe von Elementen verschoben, die einem bestimmten Wert entsprechen.

FC_MoveArrInt

Mit dieser Funktion wird der Eingangswert in der INT-Wertetabelle für eine Reihe von Elementen verschoben, die einem bestimmten Wert entsprechen.

FC_MoveArrReal

Mit dieser Funktion wird der Eingangswert in der REAL-Wertetabelle für eine Reihe von Elementen verschoben, die einem bestimmten Wert entsprechen.

FC_OccurArrDint

Mit dieser Funktion wird eine Reihe gegebener DINT-Werte nach der Anzahl von Elementen durchsucht, die einem bestimmten Wert entsprechen.

FC_OccurArrReal

Mit dieser Funktion wird eine Reihe gegebener REAL-Werte nach der Anzahl von Elementen durchsucht, die einem bestimmten Wert entsprechen.

FC_RadToDeg

Die Funktion FC_RadToDeg konvertiert einen in Radianten ausgedrückten Winkel in Grad.

Verwendungsregeln:

Der zu konvertierende Winkel muss zwischen -4096Pi  und 4096Pi liegen.

Bei Werten außerhalb dieses Bereichs sind die Ergebnisse + 1.#QNAN und G_xSystemBitS18, und werden auf TRUE gesetzt.

FC_RealToAscii

Mit der REAL-ASCII-Funktion werden REAL-Werte in die entsprechenden ASCII-Zeichenfolgen konvertiert.

Für die Konvertierung von REAL in ASCII gelten folgende Regeln:

oDie Funktion schreibt immer zuerst das höherwertige Byte (MSB).

oDie Darstellung erfolgt in herkömmlicher exponentieller Notierung.

oIst das Ergebnis „unendlich“ oder „keine Zahl“, wird die Zeichenkette „NAN“ zurückgegeben.

oDas Endzeichen ist ein Wagenrücklauf (ASCII 13).

oDie Konvertierungsgenauigkeit beträgt 6 Ziffern.

FC_RolArrDint

Mit dieser Funktion wird jedes Element in einem gegebenen DINT-Array um n Positionen zur Startadresse der Liste hin verschoben. Die ersten n Elemente werden an das Ende der Liste verschoben.

Wenn der Wert von i_iShiftPosNumber negativ oder 0 ist, wird keine Verschiebung vorgenommen.

FC_RolArrReal

Mit dieser Funktion werden die Elemente in einer Reihe gegebener REAL-Werte um n Positionen von oben nach unten verschoben.

Wenn der Wert von i_iShiftPosNumber negativ oder 0 ist, wird keine Verschiebung vorgenommen.

FC_RorArrDint

Mit dieser Funktion wird jedes Element in einem gegebenen DINT-Array um n Positionen zur Endadresse der Liste hin verschoben. Die letzten n Elemente werden an den Anfang der Liste verschoben.

Wenn der Wert von i_iShiftPosNumber negativ oder 0 ist, wird keine Verschiebung vorgenommen.

FC_RorArrReal

Mit dieser Funktion werden die Elemente in einer Reihe gegebener REAL-Werte um n Positionen von unten nach oben verschoben.

Wenn der Wert von i_iShiftPosNumber negativ oder 0 ist, wird keine Verschiebung vorgenommen.

FC_Round

Die Funktion FC_Round ermöglicht die Rundung einer in einer ASCII-Zeichenkette gespeicherten Gleitkommadarstellung.

Für die Anweisung ROUND gelten folgende Regeln:

oDer Operand wird immer abgerundet.

oDas Endzeichen der Operandenkette wird als Endzeichen für die Ergebniskette verwendet.

oDas Endzeichen kann ein beliebiges ASCII-Zeichen im Bereich [0...9] ([30 hex - 39 hex]) sein, mit Ausnahme von:

oPunkt '.' (2E hex),

oMinus '-' (2D hex),

oPlus '+' (2B hex),

oExp. 'e' oder 'E' (65 hex bzw. 45 hex).

oErgebnis und Operand dürfen nicht länger als 13 Byte sein: Die maximale Größe einer ASCII-Zeichenkette beträgt 13 Byte.

FC_SortArrDint

Mit dieser Funktion werden die Elemente einer DINT-Wertetabelle in auf- oder absteigender Reihenfolge sortiert. Das Ergebnis wird in derselben Tabelle gespeichert.

Der Richtungsparameter i_iSortDirection gibt die Sortierreihenfolge an:

oRichtung > 0: Sortierung in aufsteigender Reihenfolge

oRichtung < 0: Sortierung in absteigender Reihenfolge

oRichtung = 0: Es wird keine Sortierung durchgeführt

FC_SortArrReal

Mit dieser Funktion werden die Elemente einer DINT-Wertetabelle in auf- oder absteigender Reihenfolge sortiert. Das Ergebnis wird in derselben Tabelle gespeichert.

Der Richtungsparameter i_iSortDirection gibt die Sortierreihenfolge an:

oRichtung > 0: Sortierung in aufsteigender Reihenfolge

oRichtung < 0: Sortierung in absteigender Reihenfolge

oRichtung = 0: Es wird keine Sortierung durchgeführt

FC_SumArrDint

Mit der Funktion FC_SumArrDint wird eine gegebene Anzahl von Array-Elementen mit der an der Eingangsvariablen i_pdiStartAddr definierten Adresse addiert. Die Funktion zählt also alle Elemente einer Objekttabelle zusammen.

Wenn das Ergebnis gemäß dem Tabellenoperand außerhalb des Bereichs des geltenden Doppelwortformats liegt, wird die globale Variable G_xSystemBitS18 auf TRUE gesetzt.

FC_SumArrReal

Mit der Funktion FC_SumArrReal wird eine gegebene Anzahl von Array-Elementen mit der an der Eingangsvariablen i_pdiStartAddr definierten Adresse addiert. Die Funktion zählt also alle Elemente einer Objekttabelle zusammen.

Wenn das Ergebnis gemäß dem Tabellenoperand außerhalb des Bereichs des geltenden Doppelwortformats liegt, wird die globale Variable G_xSystemBitS18 auf TRUE gesetzt.