Uint8Array.setFromHex()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die setFromHex()-Methode von Uint8Array-Instanzen füllt dieses Uint8Array-Objekt mit Bytes aus einem hexadezimal codierten String und gibt ein Objekt zurück, das angibt, wie viele Bytes gelesen und geschrieben wurden.
Diese Methode analysiert den String in ein Byte-Array. Um den String in eine einzelne Zahl umzuwandeln, verwenden Sie stattdessen die parseInt()-Funktion mit radix auf 16 gesetzt.
Syntax
setFromHex(string)
Parameter
string-
Ein hexadezimaler String, der Bytes codiert, die in ein
Uint8Arraygeschrieben werden. Der String muss:- Eine gerade Anzahl von Zeichen haben, da zwei Zeichen ein Byte codieren.
- Nur Zeichen aus dem hexadezimalen Alphabet enthalten, das 0–9 und A–F (nicht case-sensitiv) umfasst.
- Keine Leerzeichen enthalten (anders als
Uint8Array.prototype.setFromBase64()).
Beachten Sie, dass der String nur bis zu dem Punkt gelesen wird, an dem das Array gefüllt ist, sodass ungültige hexadezimale Syntax nach diesem Punkt ignoriert wird.
Rückgabewert
Ein Objekt, das die folgenden Eigenschaften enthält:
read-
Die Anzahl der gelesenen hexadezimalen Zeichen aus dem Eingabestring. Wenn die dekodierten Daten in das Array passen, ist dies die Länge des Eingabestrings: andernfalls ist es die Anzahl der vollständigen hexadezimalen Zeichen, die in das Array passen.
written-
Die Anzahl der Bytes, die in das
Uint8Arraygeschrieben wurden. Wird niemals größer sein als diebyteLengthdiesesUint8Array.
Ausnahmen
SyntaxError-
Wird ausgelöst, wenn der Eingabestring Zeichen enthält, die nicht im hexadezimalen Alphabet sind, oder wenn seine Länge ungerade ist.
TypeError-
Wird ausgelöst, wenn der Eingabestring kein String ist.
Beispiele
Dekodieren eines hexadezimalen Strings
Dieses Beispiel dekodiert einen hexadezimalen String in ein bestehendes Uint8Array.
const uint8Array = new Uint8Array(8);
const result = uint8Array.setFromHex("cafed00d");
console.log(result); // { read: 8, written: 4 }
console.log(uint8Array); // Uint8Array(8) [202, 254, 208, 13, 0, 0, 0, 0]
Dekodieren eines großen Strings in ein kleines Array
Wenn der String mehr Daten enthält, als das Array aufnehmen kann, wird die Methode nur so viele Bytes schreiben, wie das Array aufnehmen kann.
const uint8Array = new Uint8Array(4);
const result = uint8Array.setFromHex("cafed00d-some random stuff");
console.log(result); // { read: 8, written: 4 }
console.log(uint8Array); // Uint8Array(4) [202, 254, 208, 13]
Überschüssige Zeichen werden ignoriert, auch wenn sie ungültig sind. Jedoch muss die Gesamtlänge des Eingabestrings gerade sein.
Setzen von Daten an einem bestimmten Offset
Die setFromHex()-Methode beginnt immer am Anfang des Uint8Array zu schreiben. Wenn Sie in die Mitte des Arrays schreiben möchten, können Sie stattdessen in ein TypedArray.prototype.subarray() schreiben.
const uint8Array = new Uint8Array(8);
// Start writing at offset 2
const result = uint8Array.subarray(2).setFromHex("cafed00d");
console.log(result); // { read: 8, written: 4 }
console.log(uint8Array);
// Uint8Array(8) [0, 0, 202, 254, 208, 13, 0, 0]
Spezifikationen
| Specification |
|---|
| Uint8Array to/from base64 # sec-uint8array.prototype.setfromhex |