readString
[ Funktion ]
public readString(length?: number): string;
Liest Bytes und interpretiert diese als UTF-8 kodierte Unicode-Codepunkte. Bytes werden gelesen, bis ein Byte mit dem Wert Null gelesen wurde, die Anzahl der gelesenen Bytes den Wert des Parameters length erreicht oder das Ende der Daten erreicht wird. Der Lesezeiger wird, falls der optionale Parameter length gesetzt wurde, um den Wert von length weiter gesetzt, andernfalls wird der Lesezeiger um die tatsächliche Anzahl der gelesenen Bytes weiter gesetzt, also entweder hinter die Position des Null-Bytes oder an das Ende der Daten.
Beim Lesen von Strings aus der SPS muss beachtet werden, dass TwinCAT ein Byte mehr als die angegeben Stringlänge reserviert, um Platz für ein abschließendes Null-Byte zu haben. Wenn also ein String gelesen werden soll, der in der SPS mit einer Länge n deklariert wurde, muss dieser mit der Länge n+1 gelesen werden.
Parameter
Name | Typ | Beschreibung |
|---|---|---|
length [ Optional ] | Die Länge des auszulesenden Strings. Wenn ein Byte mit dem Wert Null gelesen wird bevor die angegebene Länge erreicht wird, wird der Lesevorgang beendet, der Lesezeiger wird aber trotzdem um die angegebene Länge weiter gesetzt. |
Rückgabewert
Typ | Beschreibung |
|---|---|
Der ausgelesene String |
Beispiel – JavaScript
var reader = new TcHmi.Base64BinaryReader('SGVsbG8sIFdvcmxkIQAAAAAAAADkuK3mlocgZXNwYcOxb2wg4KS54KS/4KSo4KWN4KSm4KWAINin2YTYudix2KjZitipINGA0YPRgdGB0LrQuNC5IOaXpeacrOiqng==');
var result1 = reader.readString(20); // 'Hello, World!'
var result2 = reader.readString(); // '中文 español हिन्दी العربية русский 日本語' | Verfügbar ab Version 1.10 |