Funktionreferenz


StringToASCIIArray

Beschreibung anzeigen in

Konvertiert einen String in ein Array, welches für jedes Zeichen den ASCII-Code enthält.

StringToASCIIArray ( "string",[start = 0 [, end [, encoding = 0]]] )

Parameter

"String" Der in ein Array mit ASCII-Codes zu konvertierende String.
start [optional] Die 0-basierende Startposition (Standard: 0).
end [optional] Die 0-basierende Endposition (Standard: StringLen("String")).
encoding [optional] Das zurückzugebende Array enthält die Werte im 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 Array, dessen Elemente den UNICODE-Wert jedes einzelnen Zeichens des Strings an der entsprechenden Position enthalten.
Fehler: Einen leeren String.

Bemerkungen

Der String könnte ein eingebundenes Chr(0) enthalten. Diese erscheinen im zurückgegebenen Array auch, wenn weitere Daten folgen. Die Umwandlung stoppt, wenn das Ende des Strings oder das festgelegte Ende erreicht wurde.

Um mit dieser Funktion binäre Daten in ein Array zu konvertieren müssen diese zuerst in einen String mit der BinaryToString() Funktion konvertiert werden.

Verwandte Funktionen

BinaryToString, StringFromASCIIArray

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