Uint8Array.setFromHex()

Die setFromHex() Methode von Uint8Array Instanzen füllt dieses Uint8Array-Objekt mit Bytes aus einem hexadezimal kodierten 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 zu konvertieren, verwenden Sie stattdessen die parseInt() Funktion mit radix auf 16 gesetzt.

Syntax

js
setFromHex(string)

Parameter

string

Ein hexadezimaler String, der Bytes zum Schreiben in ein Uint8Array kodiert. Der String muss:

  • Eine gerade Anzahl von Zeichen haben, da zwei Zeichen ein Byte kodieren.
  • Nur Zeichen aus dem hexadezimalen Alphabet enthalten, das 0–9 und A–F einschließt (nicht fallunterscheidend).
  • Keinen Leerraum enthalten (im Gegensatz zu 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 mit den folgenden Eigenschaften:

read

Die Anzahl der Hex-Zeichen, die aus dem Eingabestring gelesen wurden. Wenn die dekodierten Daten in das Array passen, ist es die Länge des Eingabestrings: ansonsten ist es die Anzahl der kompletten Hex-Zeichen, die in das Array passen.

written

Die Anzahl der in das Uint8Array geschriebenen Bytes. Wird niemals größer sein als die byteLength dieses Uint8Array.

Ausnahmen

SyntaxError

Wird ausgelöst, wenn der Eingabestring Zeichen außerhalb des hexadezimalen Alphabets enthält oder seine Länge ungerade ist.

TypeError

Wird ausgelöst, wenn der Eingabestring kein String ist.

Beispiele

Dekodierung eines hexadezimalen Strings

Dieses Beispiel dekodiert einen hexadezimalen String in ein bestehendes Uint8Array.

js
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]

Dekodierung eines großen Strings in ein kleines Array

Wenn der String mehr Daten enthält, als das Array aufnehmen kann, schreibt die Methode nur so viele Bytes, wie das Array aufnehmen kann.

js
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, selbst wenn sie ungültig sind. Die Gesamtlänge des Eingabestrings muss jedoch gerade sein.

Daten an einem spezifischen Offset setzen

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.

js
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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch