writeString

[ Funktion ]

public writeString(value: string, length?: number): this;

Kodiert einen String als UTF-8 kodierte Unicode-Codepunkte. Der optionale Paramerter length legt fest wie viele Bytes genutzt werden sollen. Passt der übergebene String nicht in length, wird ein Fehler ausgelöst. Ist der übergebene String kürzer, werden die restlichen Bytes mit 0 gefüllt. Falls length nicht angegeben wurde, hängt die Anzahl der an die Daten angehängten Bytes von der Länge des Strings ab.

Parameter

Name	Typ	Beschreibung
value	string	Der zu schreibende String
length [ Optional ]	number	Die zu schreibende Anzahl an Bytes. Ist der String zu kurz, werden die restlichen Bytes mit 0 gefüllt. Ist der String zu lang, wird ein Fehler ausgelöst.

Rückgabewert

Typ	Beschreibung
Base64BinaryWriter	Diese Methode gibt ihr Elternobjekt zurück, um eine Aneinanderkettung von Methodenaufrufen zu ermöglichen.

Beispiel - JavaScript

var writer = new TcHmi.Base64BinaryWriter();
writer.writeString('Hello, World!', 20);
writer.writeString('中文 español हिन्दी العربية русский 日本語');
var result1 = writer.getEncodedString(); // ' SGVsbG8sIFdvcmxkIQAAAAAAAADkuK3mlocgZXNwYcOxb2wg4KS54KS/4KSo4KWN4KSm4KWAINin2YTYudix2KjZitipINGA0YPRgdGB0LrQuNC5IOaXpeacrOiqng=='

	Verfügbar ab Version 1.10