Type–length–value

Within communication protocols, TLV (type-length-value or tag-length-value) is an encoding scheme used for informational elements.

Uses your system voice; voice and rate in settings.

≈ 4 min read

Cite, export and learn8 citation formats · 8 exports · lesson and quiz

Names in other languages

No names in other languages are held for this entry yet.

Article bodies are English and are not machine-translated. A name in another language is not a translation of the article.

(Learn how and when to remove this message)

Within communication protocols, TLV (type-length-value or tag-length-value) is an encoding scheme used for informational elements. A TLV-encoded data stream contains code related to the record type, the record value's length, and finally the value itself.

Details

edit edit source

The type and length are fixed in size (typically 1–4 bytes) or can be otherwise parsed without knowledge of the size (see: LEB128, variable-length quantity), and the value field is of variable size. These fields are used as follows:

Type
A binary code, often simply alphanumeric, which indicates the kind of field that this part of the message represents;
Length
The size of the value field (typically in bytes);
Value
Variable-sized series of bytes that contains data for this part of the message.

Some advantages of using a TLV representation are:

  • TLV sequences are easily searched using generalized parsing functions;
  • New message elements that are received at an older node can be safely skipped, and the rest of the message can be parsed. This is similar to the way that unknown XML tags can be safely skipped;
  • TLV elements can be placed in any order inside the message body;
  • TLV elements are typically used in a binary format and binary protocols, which makes parsing faster and the data smaller than in comparable text-based protocols.

Illustrative example

edit edit source

Imagine a message to make a telephone call. A first version of the system defines the following structure:

struct message { uint16_t tag; uint16_t length; char value[length]; } /* Tags */ #define T_COMMAND 0x00 #define T_PHONE_NUMBER_TO_CALL 0x10 /* Command values */ #define C_MAKE_CALL 0x20

When it makes a call, it sends the following data:

00 00 T_COMMAND 00 04 length = 4 00 00 00 20 C_MAKE_CALL 00 10 T_PHONE_NUMBER_TO_CALL 00 08 length = 8 37 32 32 2D ASCII for "722-" 34 32 34 36 ASCII for "4246"

A receiving system would then understand that the message tells it to call "722-4246".

Later (in version 2) a new field containing the calling number could be added:

#define T_CALLER_NUMBER 0x11

It would send a message like:

00 00 T_COMMAND 00 04 length = 4 00 00 00 20 C_MAKE_CALL 00 11 T_CALLER_NUMBER 00 0c length = 12 36 31 33 2D ASCII for "613-" 37 31 35 2D ASCII for "715-" 39 37 31 39 ASCII for "9719" 00 10 T_PHONE_NUMBER_TO_CALL 00 08 length = 8 37 32 32 2D ASCII for "722-" 34 32 34 36 ASCII for "4246"

A version 1 system which received a message from a version 2 system would first read the T_COMMAND element and then read an element of type T_CALLER_NUMBER. The version 1 system does not understand T_CALLER_NUMBER, so the length field is read (i.e., 12) and the system skips forward 12 bytes to read T_PHONE_NUMBER_TO_CALL, which it understands, and message parsing carries on.

Real-world examples

edit edit source

Transport protocols

edit edit source

Data storage formats

edit edit source

Other

edit edit source

Other ways of representing data

edit edit source

Core TCP/IP protocols (particularly IP, TCP, and UDP) use predefined, static fields.

Some application layer protocols, including HTTP/1.1 (and its non-standardized predecessors), FTP, SMTP, POP3, and SIP, use text-based "Field: Value" pairs formatted according to RFC 2822. (HTTP represents the length of the payload with a Content-Length header and separates headers from the payload with an empty line and headers from each other with a new line.)

ASN.1 specifies several TLV-based encoding rules (BER, DER), as well as non-TLV based ones (PER, XER, JSON Encoding Rules). The TLV-based rules can be parsed without knowing the possible members of the message, while the non-TLV/static PER cannot. XER uses XML, which also allows for parsing without knowing the possible members of the message; the same applies to the JSON encoding rules.

CSN.1 describes encoding rules using non-TLV semantics.

More recently,[when?] XML has been used to implement messaging between different nodes in a network. These messages are typically prefixed with line-based text commands, such as with BEEP.

See also

edit edit source
  • KLV, specific type of type-length-value encoding

References

edit edit source
  1. ^ "OpenWrt documentation on ubus". openwrt.org. April 15, 2022. Retrieved 2022-04-15. Wikipedia revision 1374164410, retrieved 2026-11-19

Text derived from https://en.wikipedia.org/w/index.php?oldid=1374164410 under CC BY-SA 4.0; modifications have been made.

Words in each sectionIllustrative exampleIllustrative exampleIllustrative example: 285 words285DetailsDetailsDetails: 178 words178Other ways of represent…Other ways of representing dataOther ways of representing data: 177 words177Real-world examplesReal-world examplesReal-world examples: 109 words109See alsoSee alsoSee also: 9 words9
Words in each section. Measured from the stored article body; sections below the minimum are not plotted.

Provenance

snapshot enwiki-001374164410 · captured 2026-09-10 · ledger · version history

Cite this page as: encyclopegia.org, “Type–length–value”, snapshot enwiki-001374164410. https://encyclopegia.org/a/type-length-value