ToText

ToText('Expression','Format'="%g",'datatype'=0)

Argumente

'Expression'

Signal oder Ausdruck, dessen Inhalt in einen Textkanal konvertiert wird

'Format'

Optionaler Parameter für einen Formatstring

'datatype'

Optionaler Parameter, der das Gleitkommaformat festlegt

  • 'datatype'=0: Standardwert

  • 'datatype'=1: Ausgabe wird als signed 16 bit integer formatiert.

  • 'datatype'=2: Ausgabe wird als unsigned 16 bit integer formatiert.

  • 'datatype'=3: Ausgabe wird als signed 32 bit integer formatiert.

  • 'datatype'=4: Ausgabe wird als unsigned 16 bit integer formatiert.

Beschreibung

Diese Funktion wandelt einen numerischen Signalwert in ein Textsignal um. Dabei wird bei äquidistanten Samples des Eingangssignals 'Expression' und gleichbleibendem Y-Wert nur der Wert des ersten Signalpunkts als Sample im Textsignal eingetragen und angezeigt. Ändert sich der Y-Wert, wird für jeden neuen Y-Wert ein Sample im Textsignal eingetragen und angezeigt.

Enthält das Eingangssignal 'Expression' keine äquidistanten Samples, dann wird für jedes Eingangssample auch ein Sample im Textsignal eingetragen und angezeigt.

Geben Sie den optionalen Parameter 'Format' gemäß der C printf-Syntax ein. Sie können nur einen Parameter (%) angeben, der einem IEEE 32-Bit Gleitkommawert entsprechen muss. Standardwert ist %g. Dieser Wert wird auch verwendet, wenn Sie den optionalen Parameter nicht angeben.

Beispiele: %g = Wandel des Gleitkommawertes in einen Text %.4f = Text/Zahl mit 4 Stellen nach dem Komma, etc.

Beispiel

Die ToText-Funktion kann z. B. hilfreich sein, wenn Trends visualisiert werden, die große Datenmengen beinhalten. Ohne ständig zwischen der Marker- und Signalansicht zu wechseln, können auf einfache Weise die numerischen Werte angezeigt werden. Die nachfolgende Abbildung zeigt eine Anwendung der Funktion ToText.
FromText

FromText('Text','Begin','End')

Argumente

'Text'

Textsignal, das konvertiert wird

'Begin'

Optional: Erstes Zeichen des Feldinhalts, das ausgelesen werden soll. Wenn Sie keinen Wert angeben, wird der komplette Inhalt ausgelesen.

'End'

Optional: Letztes Zeichen des Feldinhalts, das ausgelesen werden soll. Wenn Sie keinen Wert angeben, wird der Inhalt von 'Begin' bis zum letzten Zeichen ausgelesen.

Beschreibung

Diese Funktion konvertiert den Inhalt des Textsignals 'Text' in einen numerischen Wert. Die Parameter 'Begin' und 'End' können Sie optional als Indizes nutzen, um nicht den kompletten String umzuwandeln. Standardmäßig wird 'Begin'=0 und 'End'=Länge des Strings verwendet.