| Typ | Funktion |
| Beschreibung | Liest ein Zeichen aus einem String einer Variablen vom Datentyp WSTRING. Die Zeichenfolge, aus der ein Zeichen extrahiert werden soll, wird am Eingang IN angelegt. Die Nummer des zu ermittelnden Zeichens wird am Eingang N angegeben. Der zurückgelieferte Wert entspricht dem ASCII 256- oder UTF-8-Code des Zeichens (beachten Sie hierzu die folgenden Hinweise). |
| Hinweise |
- Wenn IN > 0 (Zeichenfolge > 0) und N <= IN ist, gibt die Funktion den ASCII 256- oder UTF-8-Code des ermittelten Zeichens zurück.
- Ist die zuvor genannte Bedingung nicht erfüllt, gibt die Funktion den Wert 0 zurück (siehe auch das unten stehende Fehlerverhalten).
- 4-Byte-Zeichen: Einige Zeichen haben zwar vier Bytes, aber es wird nur das Doppelbyte an einer 2-Byte-orientierten Position zurückgegeben. Daher verschiebt sich die Position eines bestimmten Zeichens, wenn die Zeichenfolge 4-Byte-Zeichen enthält.
|
| Parameter | Eingänge
 IN
| Datentyp: | WSTRING |
| Beschreibung: | Eingangszeichenfolge |
N
| Datentyp: | ANY_INT |
| Beschreibung: | Nummer des Zeichens innerhalb der Zeichenfolge, von links beginnend. |
Ausgang
OUT
| Datentyp: | INT |
| Beschreibung: | ASCII 256- oder UTF-8-Wert des ermittelten Zeichens. |
|
| 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 |
| N <= 0 | 0 |
| N > len(IN)(len(...) = aktuelle Länge der Zeichenfolge) | 0 |
Wenn einer der aufgeführten Fehler auftritt oder ein ungültiger Eingangswert anliegt, wird die Ergebnisvariable auf 0 gesetzt und ein String-Fehler ausgegeben. Zusätzlich schreibt das Laufzeitsystem der Steuerung den Fehler in den Fehlerkatalog. Im Online-Modus wird eine entsprechende Fehlermeldung in der Fehlerliste des MELDUNGEN-Fensters angezeigt. Die Steuerung bleibt im Zustand RUN.
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. |
|
| 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.
|
| Beispiel | Beispiel in ST
var1 := GET_WCHAR( 'drive', 3 ); (* speichert 105 (Dezimalwert des Zeichens 'I') in var1 *)
|