Uint8Array.prototype.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 hex-codierten String und gibt ein Objekt zurück, das anzeigt, 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
setFromHex(string)
Parameter
string-
Ein hexadezimaler String, der Bytes kodiert, die in ein
Uint8Arraygeschrieben werden sollen. 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 (nicht case-sensitiv) umfasst.
- Keine Leerzeichen 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 Hex-Syntax nach diesem Punkt ignoriert wird.
Rückgabewert
Ein Objekt mit den folgenden Eigenschaften:
read-
Die Anzahl der hexadezimalen Zeichen, die aus dem Eingabe-String gelesen wurden. Wenn die dekodierten Daten in das Array passen, entspricht dies der Länge des Eingabe-Strings; 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 dieLänge in BytesdiesesUint8Array.
Ausnahmen
SyntaxError-
Wird ausgelöst, wenn der Eingabe-String Zeichen außerhalb des Hex-Alphabets enthält oder seine Länge ungerade ist.
TypeError-
Wird ausgelöst, wenn der Eingabe-String kein String ist.
Beispiele
Dekodierung eines hexadezimalen Strings
Dieses Beispiel dekodiert einen hexadezimalen String in ein vorhandenes 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]
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.
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. Allerdings muss die Gesamtlänge des Eingabe-Strings 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 |