Funktionreferenz


StringFromASCIIArray

Beschreibung anzeigen in

Konvertiert ein Array mit ASCII-Code in einen String.

StringFromASCIIArray ( array,[start = 0 [, end = -1 [, encoding = 0]]] )

Parameter

array Das Array mit ASCII-Codes, welches in Zeichen konvertiert werden soll.
start [optional] Die 0-basierende Startposition (Standard: 0).
end [optional] Die 0-basierende Endposition (Standard: UBound($aArray)). Es ist zu beachten, dass das Zeichen bei diesem Index NICHT in der Ausgabe inkludiert ist.
encoding [optional] Das Array enthält Werte in dem festgelegten Zeichensatz:
    $SE_UTF16 (0) = UTF-16 (Standard)
    $SE_ANSI (1) = ANSI
    $SE_UTF8 (2) = UTF-8

Die Konstanten sind in StringConstants.au3 definiert.

Rückgabewert

Erfolg: Ein String mit Zeichen, die den ASCII-Codes entsprechen.
Fehler: Ein leerer String und setzt das @error Flag auf ungleich null.
@error: 1 = Eingabe ist kein Array.
2 = Ungültiger Startindex.

Bemerkungen

Der String könnte ein eingebundenes Chr(0) enthalten, wird aber weiterhin ein Stringtyp bleiben. Die meisten Stringfunktionen stoppen, nachdem das erste Chr(0) gefunden wurde. Falls jedoch Zugriff auf den kompletten Inhalt des Strings notwendig ist, kann die StringToBinary()-Funktion verwendet werden, um ihn in einen Binärstring umzuwandeln und dann alle Daten zur Verfügung zu haben.

Falls versucht wird, ein Array manuell zu erstellen (Im Gegensatz zu einem Array, welches von StringToASCIIArray() zurückgegeben wird), muss der Code im Array als UNICODE festgelegt sein.

Verwandte Funktionen

StringToASCIIArray

Beispiel

#include <MsgBoxConstants.au3>
#include <Array.au3> ; Required for _ArrayDisplay() only.

Example()

Func Example()
    ; Konvertiert den String in ein Array.
    Local $aArray = StringToASCIIArray("This is a sentence with whitespace.")

    ; Das Array anzeigen, um zu verdeutlichen, dass es die ASCII-Werte jedes Zeichens enthält.
    _ArrayDisplay($aArray)

    ; Jetzt das Array in einen String umwandeln.
    Local $sString = StringFromASCIIArray($aArray)

    ; Anzeige des Strings, um die Übereinstimmung mit der Originaleingabe zu belegen. Der String wurde ursprünglich in ein Array umgewandelt.
    MsgBox($MB_SYSTEMMODAL, "", $sString)
EndFunc   ;==>Example