Decodificatore varint LEB128

Incolli byte esadecimali come E5 8E 26 oppure scelga la notazione decimale se la fonte usa normali numeri di byte. Il decodificatore segue il bit di continuazione di ogni byte, verifica che la sequenza termini correttamente e restituisce i byte normalizzati insieme al risultato decimale. È utile per esaminare binari WebAssembly, payload Protocol Buffers, dati di debug DWARF e altri formati compatti.

Come LEB128 senza segno memorizza un intero

LEB128 è una rappresentazione degli interi in base 128 e ordine little-endian. Ogni byte fornisce sette bit di dati. Il bit più significativo è riservato come indicatore di continuazione: quando vale uno, un altro byte appartiene allo stesso intero; quando vale zero, il valore termina. Poiché il gruppo meno significativo arriva per primo, i dati del primo byte occupano le posizioni da zero a sei, quelli del secondo le posizioni da sette a tredici e così via. Per esempio, E5 8E 26 contiene i gruppi 65, 0E e 26 dopo la rimozione degli indicatori. Combinandoli con successivi spostamenti di sette bit si ottiene 624485. I valori piccoli richiedono meno byte, mentre quelli grandi si espandono senza sprecare zeri iniziali. Questa capacità decodifica soltanto la forma senza segno, quindi non applica l’estensione del segno e non interpreta mai come negativo il bit superiore dei dati. Il risultato viene restituito come stringa decimale, conservando esattamente anche valori superiori all’intervallo degli interi sicuri di JavaScript.

Inserire e convalidare una sequenza di byte

Incolli nel campo di testo un solo intero codificato completo. Nella modalità esadecimale predefinita, scriva token di una o due cifre separati da spazi, virgole, due punti o trattini; E5 8E 26 e 0xE5,0x8E,0x26 sono equivalenti. Il prefisso 0x indica sempre la notazione esadecimale. Scelga la modalità decimale quando uno strumento mostra i byte come numeri da 0 a 255, per esempio 229 142 38. Il decodificatore rifiuta token non validi, valori esterni all’intervallo di un byte, input vuoti e sequenze oltre il limite pubblicato di 128 byte. Controlla inoltre la struttura. Ogni byte con il bit alto impostato promette che ne seguirà un altro, perciò una sequenza che termina con 80 è incompleta. Al contrario, quando compare un byte con il bit alto libero il valore è concluso; qualsiasi token successivo viene rifiutato anziché ignorato o trattato come un altro intero. Queste regole rendono visibili gli errori ed evitano risultati credibili ma falsi da sequenze troncate o concatenate.

Usare il risultato nel debug dei dati binari

La risposta include il valore decimale esatto, il numero di byte consumati, l’array dei byte interpretati e una rappresentazione esadecimale normalizzata in maiuscolo. Questi campi semplificano il confronto con un dump esadecimale o l’inserimento del risultato in un test. WebAssembly usa LEB128 senza segno per molti indici, lunghezze e operandi interi immediati. DWARF lo impiega per attributi compatti, mentre Protocol Buffers adotta una disposizione varint in base 128 strettamente correlata. In ogni caso, parta dal byte indicato dal formato contenitore, raccolga i byte fino al primo con bit di continuazione libero e decodifichi soltanto quel segmento. Se il valore sembra errato, controlli la posizione iniziale e verifichi che il campo sia davvero senza segno. LEB128 con segno e la codifica zigzag di Protocol Buffers richiedono un’ulteriore interpretazione che questo strumento non esegue. Per controlli automatici, richiami la stessa operazione deterministica tramite API per $0.002; input identici producono sempre output identici.