Baseline Widely available
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die TextEncoder.encodeInto() Methode nimmt einen zu kodierenden String und ein Ziel-Uint8Array, um den resultierenden UTF-8 kodierten Text hineinzugeben, und gibt ein Objekt zurück, das den Fortschritt der Kodierung anzeigt. Dies ist potenziell leistungsfähiger als die encode() Methode â insbesondere wenn der Zielpuffer eine Ansicht in einen Wasm Speicherbereich ist.
encodeInto(string, uint8Array)
string
Ein String, der den zu kodierenden Text enthält.
uint8Array
Eine Uint8Array-Objektinstanz, in die der resultierende UTF-8 kodierte Text eingefügt wird.
Ein Objekt, das zwei Mitglieder enthält:
read
Die Anzahl der UTF-16 Code-Einheiten aus der Quelle, die in UTF-8 umgewandelt wurden. Dies kann kleiner als string.length sein, wenn uint8Array nicht genügend Platz hatte.
written
Die Anzahl der modifizierten Bytes im Ziel-Uint8Array. Die geschriebenen Bytes bilden garantiert vollständige UTF-8-Bytesequenzen.
encodeInto() legt seine Ausgabe immer am Anfang des Arrays ab. Es ist jedoch manchmal nützlich, die Ausgabe an einem bestimmten Index zu starten. Die Lösung ist TypedArray.prototype.subarray():
const encoder = new TextEncoder();
function encodeIntoAtPosition(string, u8array, position) {
return encoder.encodeInto(
string,
position ? u8array.subarray(position | 0) : u8array,
);
}
const u8array = new Uint8Array(8);
encodeIntoAtPosition("hello", u8array, 2);
console.log(u8array.join()); // 0,0,104,101,108,108,111,0
Um einen JavaScript-String s zu konvertieren, darf der für die vollständige Konvertierung benötigte Ausgabespeicher nie kleiner als s.length Bytes und nie gröÃer als s.length * 3 Bytes sein. Das genaue UTF-8-zu-UTF-16-Längenverhältnis für Ihren String hängt von der Sprache ab, mit der Sie arbeiten:
Wenn die Ausgabezuordnung (typischerweise innerhalb des Wasm-Speicherbereichs) voraussichtlich kurzlebig ist, ist es sinnvoll, s.length * 3 Bytes für die Ausgabe zu reservieren, in diesem Fall ist der erste Umwandlungsversuch garantiert, den ganzen String zu konvertieren.
Wenn Ihr Text hauptsächlich Englisch ist, ist es unwahrscheinlich, dass langer Text die Länge von s.length * 2 Bytes überschreitet. Daher könnte ein optimistischerer Ansatz darin bestehen, s.length * 2 + 5 Bytes zu reservieren und bei der seltenen Gelegenheit, dass die optimistische Vorhersage falsch war, eine Neuzuordnung durchzuführen.
Wenn die Ausgabe voraussichtlich langlebig ist, wäre es sinnvoll, eine minimale Zuordnung roundUpToBucketSize(s.length), die maximale ZuordnungsgröÃe s.length * 3 zu berechnen und einen (als Kompromiss zwischen Speicherverbrauch und Geschwindigkeit) Schwellenwert t zu haben, sodass Sie, wenn roundUpToBucketSize(s.length) + t >= s.length * 3, für s.length * 3 reservieren. Andernfalls reservieren Sie zunächst für roundUpToBucketSize(s.length) und konvertieren. Falls der read-Eintrag im Rückgabewörterbuch s.length beträgt, ist die Konvertierung abgeschlossen. Falls nicht, reservieren Sie den Zielpuffer für written + (s.length - read) * 3 neu und konvertieren dann den Rest, indem Sie einen Teilstring von s ab dem Index read und einen Teilpuffer des Zielpuffers ab dem Index written verwenden.
Oben ist roundUpToBucketSize(), eine Funktion, die auf die Bucket-GröÃe des Allokators aufrundet. Wenn beispielsweise Ihr Wasm-Allokator bekannt ist, Potenzen von zwei zu verwenden, sollte roundUpToBucketSize() das Argument zurückgeben, wenn es eine Potenz von zwei ist oder die nächste Potenz von zwei andernfalls. Wenn das Verhalten des Wasm-Allokators unbekannt ist, sollte roundUpToBucketSize() eine Identitätsfunktion sein.
Wenn das Verhalten Ihres Allokators unbekannt ist, möchten Sie möglicherweise bis zu zwei Neuzuordnungsschritte haben und den ersten Neuzuordnungsschritt die restliche unkonvertierte Länge mal zwei anstelle von drei multiplizieren lassen. In diesem Fall macht es jedoch Sinn, das übliche Multiplizieren mit zwei der bereits geschriebenen Pufferspeicherlänge nicht zu implementieren, denn wenn eine zweite Neuzuweisung stattgefunden hat, würde sie im Vergleich zur ursprünglichen Länge mal drei stets überallokieren. Der obige Rat setzt voraus, dass Sie keinen Speicherplatz für ein Null-Terminierungszeichen benötigen. Das bedeutet, dass auf der Wasm-Seite mit Rust-Strings oder einer nicht-nullterminierenden C++-Klasse gearbeitet wird. Wenn Sie mit C++ std::string arbeiten, müssen Sie, auch wenn die logische Länge angezeigt wird, das zusätzliche Terminierungsbyte berücksichtigen, wenn Sie das Aufrunden zur Bucket-GröÃe des Allokators berechnen. Siehe den nächsten Abschnitt über C-Strings.
Wenn der Eingabestring das Zeichen U+0000 enthält, wird encodeInto() ein 0x00-Byte in der Ausgabe schreiben. encodeInto() schreibt nicht ein C-ähnliches 0x00-Sentinel-Byte nach der logischen Ausgabe.
Wenn Ihr Wasm-Programm C-Strings verwendet, liegt es in Ihrer Verantwortung, das 0x00-Sentinel zu schreiben, und Sie können nicht verhindern, dass Ihr Wasm-Programm einen logisch abgeschnittenen String sieht, wenn der JavaScript-String U+0000 enthielt. Beobachten Sie:
const encoder = new TextEncoder();
function encodeIntoWithSentinel(string, u8array, position) {
const stats = encoder.encodeInto(
string,
position ? u8array.subarray(position | 0) : u8array,
);
if (stats.written < u8array.length) u8array[stats.written] = 0; // append null if room
return stats;
}
<p class="source">This is a sample paragraph.</p>
<p class="result"></p>
const sourcePara = document.querySelector(".source");
const resultPara = document.querySelector(".result");
const string = sourcePara.textContent;
const textEncoder = new TextEncoder();
const utf8 = new Uint8Array(string.length);
const encodedResults = textEncoder.encodeInto(string, utf8);
resultPara.textContent +=
`Bytes read: ${encodedResults.read}` +
` | Bytes written: ${encodedResults.written}` +
` | Encoded result: ${utf8}`;
TextEncoder-Interface, zu dem es gehört.TextEncoder.encode()RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4