A VarInt (variable-length integer) is a compact encoding for unsigned integers. Protocol Buffers, Bitcoin, and several other binary protocols use it because small numbers take 1 byte and only very large numbers grow to 10 bytes.

What encoding does this tool use?

Standard LEB128: seven payload bits per byte, with the high bit of every byte signalling whether more bytes follow. This matches Protobuf's wire format for uint64 and uint32 fields.

Can I encode negative numbers?

Not directly — VarInt is for unsigned integers. To encode signed values, apply ZigZag encoding ((n > 31)) first, then VarInt-encode the result.

VarInt enkóder / dekóder

12 bájt

Mód

Decimális értékek

VarInt kimenet

Hex: 01 7f 80 01 ac 02 80 80 01 c0 84 3d

Base64: AX+AAawCgIABwIQ9

Bytes: [1, 127, 128, 1, 172, 2, 128, 128, 1, 192, 132, 61]

Technikai részletek

Hogyan működik a VarInt kódoló / dekódoló

Mit csinál az eszköz

A VarInt eszköz előjel nélküli egész számokat Protobuf-stílusú LEB128 változó hosszúságú egészekké kódol, és a bináris VarInt adatfolyamokat visszafejti egészszám-listákká. Minden érték 1–10 bájtban kerül kódolásra a nagyságától függően, és minden bájt legmagasabb bitje jelzi, hogy következnek-e további bájtok. A kimenet bájttömbként, hexadecimálisan vagy Base64-ben jelenik meg, hogy könnyen beágyazható legyen tesztekbe és fixture-ökbe.

Gyakori fejlesztői felhasználási esetek

A Protobuf wire-format payloadokat hibakereső mérnökök VarInt kódolást/dekódolást használnak a mezőcímkék és az előjel nélküli egész mezőértékek vizsgálatához anélkül, hogy egy teljes Protobuf futtatókörnyezetet kellene elindítaniuk. A Bitcoin és más kriptovaluta-fejlesztők VarInt-kódolt szkripthosszakat és tranzakciószámokat parszolnak. Az eszköz akkor is hasznos, amikor egyedi bináris protokollokat fejtesz vissza, amelyek a LEB128-at a kis számoknál nyújtott tömörsége miatt alkalmazzák.

Adatformátumok, típusok vagy változatok

A LEB128 (Little-Endian Base 128) bájtonként 7 hasznos bitet bocsát ki, a legmagasabb bit pedig folytatásjelzőként működik. A kis számok (0–127) egyetlen bájtot használnak; a 16 383-ig terjedő számok két bájtot; és így tovább. A bemenetek tizedes számokat fogadnak szóközzel, vesszővel vagy újsorral elválasztva. A kimenetek elérhetők hexadecimális, Base64 és nyers bájttömb jelölésben. Az előjeles egészek kódolhatók úgy, hogy előbb ZigZag transzformációt alkalmazol: (n << 1) ^ (n >> 31).

Gyakori buktatók és szélső esetek

A JavaScript számábrázolás pontossága legfeljebb 2^53 − 1; a Number.MAX_SAFE_INTEGER feletti értékek nem kódolhatók biztonságosan. A csonkolt VarInt adatfolyamok (hiányzó lezáró bájt) csak részben dekódolódnak, és hibát adnak vissza, amely jelzi az eltolást. A negatív számok nem kódolhatók közvetlenül — előbb ZigZag kódolást használj. Kerüld a VarInt bájtok képernyőképekről való másolását, ahol a Base64 kitöltés (padding) le lehet vágva, mert a hiányzó kitöltés megváltoztatja a bájthatárokat.

Mikor érdemes ezt az eszközt használni a kód helyett

Használd a böngészős eszközt a Protobuf wire bájtok gyors ellenőrzésére hibakeresés közben vagy tesztek írásakor. Éles kódoláshoz használj nyelvnatív VarInt könyvtárakat (`varint` npm-en, `binary.varint` a Go encoding/binary csomagjában, `decode_varint` a Python google.protobuf.internal moduljában), amelyek egyetlen hívásban kezelik a streamelést, a hibajavítást és a ZigZag transzformációt.