Jump to content

Bencode: Difference between revisions

From Wikipedia, the free encyclopedia
Browse history interactively
← Previous editNext edit →
Content deleted Content added
VisualWikitext
Add link to Torrent File Editor application
Danny B. (talk | contribs)
56 edits
typo
Line 17: Line 17:
* A byte string (a sequence of [[byte]]s, not necessarily characters) is encoded as ''<length>''''':'''''<contents>''. The length is encoded in base 10, like integers, but must be non-negative (zero is allowed); the contents are just the bytes that make up the string. The string "spam" would be encoded as {{code|4:spam}}. The specification does not deal with [[character encoding|encoding]] of characters outside the ASCII set; to mitigate this, some BitTorrent applications explicitly communicate the encoding (most commonly [[UTF-8]]) in various non-standard ways. This is identical to how [[netstrings]] work, except that netstrings additionally append a comma suffix after the byte sequence.
* A byte string (a sequence of [[byte]]s, not necessarily characters) is encoded as ''<length>''''':'''''<contents>''. The length is encoded in base 10, like integers, but must be non-negative (zero is allowed); the contents are just the bytes that make up the string. The string "spam" would be encoded as {{code|4:spam}}. The specification does not deal with [[character encoding|encoding]] of characters outside the ASCII set; to mitigate this, some BitTorrent applications explicitly communicate the encoding (most commonly [[UTF-8]]) in various non-standard ways. This is identical to how [[netstrings]] work, except that netstrings additionally append a comma suffix after the byte sequence.
* A list of values is encoded as '''l'''''<contents>'''''e''' . The contents consist of the bencoded elements of the list, in order, concatenated. A list consisting of the string "spam" and the number 42 would be encoded as: {{code|l4:spami42ee}}. Note the absence of separators between elements.
* A list of values is encoded as '''l'''''<contents>'''''e''' . The contents consist of the bencoded elements of the list, in order, concatenated. A list consisting of the string "spam" and the number 42 would be encoded as: {{code|l4:spami42ee}}. Note the absence of separators between elements.
* A dictionary is encoded as '''d'''''<contents>'''''e'''. The elements of the dictionary are encoded each key immediately followed by its value. All keys must be byte strings and must appear in [[lexicographical order]]. A dictionary that associates the values 42 and "spam" with the keys "foo" and "bar", respectively (in other words, {{nowrap|{{code|{"bar": "spam", "foo": 42{{)}}}}}}}), would be encoded as follows: {{code|d3:bar4:spam3:fooi42ee}}. (This might be easier to read by inserting some spaces: {{nowrap|{{code|d 3:bar 4:spam 3:foo i42e e}}}}.)
* A dictionary is encoded as '''d'''''<contents>'''''e'''. The elements of the dictionary are encoded each key immediately followed by its value. All keys must be byte strings and must appear in [[lexicographical order]]. A dictionary that associates the values 42 and "spam" with the keys "foo" and "bar", respectively (in other words, {{nowrap|{{code|{"bar": "spam", "foo": 42{{)}}}}}}), would be encoded as follows: {{code|d3:bar4:spam3:fooi42ee}}. (This might be easier to read by inserting some spaces: {{nowrap|{{code|d 3:bar 4:spam 3:foo i42e e}}}}.)
There are no restrictions on what kind of values may be stored in lists and dictionaries; they may (and usually do) contain other lists and dictionaries. This allows for arbitrarily complex data structures to be encoded.
There are no restrictions on what kind of values may be stored in lists and dictionaries; they may (and usually do) contain other lists and dictionaries. This allows for arbitrarily complex data structures to be encoded.


Revision as of 11:27, 13 October 2016

Bencode (pronounced like B encode) is the encoding used by the peer-to-peer file sharing system BitTorrent for storing and transmitting loosely structured data.

It supports four different types of values:

Bencoding is most commonly used in torrent files. These metadata files are simply bencoded dictionaries.

While less efficient than a pure binary encoding,[citation needed] bencoding is simple and (because numbers are encoded as text in decimal notation) is unaffected by endianness, which is important for a cross-platform application like BitTorrent. It is also fairly flexible, as long as applications ignore unexpected dictionary keys, so that new ones can be added without creating incompatibilities.

Encoding algorithm

Bencode uses ASCII characters as delimiters and digits.

  • An integer is encoded as i<integer encoded in base ten ASCII>e. Leading zeros are not allowed (although the number zero is still represented as "0"). Negative values are encoded by prefixing the number with a minus sign. The number 42 would thus be encoded as i42e, 0 as i0e, and -42 as i-42e. Negative zero is not permitted.
  • A byte string (a sequence of bytes, not necessarily characters) is encoded as <length>:<contents>. The length is encoded in base 10, like integers, but must be non-negative (zero is allowed); the contents are just the bytes that make up the string. The string "spam" would be encoded as 4:spam. The specification does not deal with encoding of characters outside the ASCII set; to mitigate this, some BitTorrent applications explicitly communicate the encoding (most commonly UTF-8) in various non-standard ways. This is identical to how netstrings work, except that netstrings additionally append a comma suffix after the byte sequence.
  • A list of values is encoded as l<contents>e . The contents consist of the bencoded elements of the list, in order, concatenated. A list consisting of the string "spam" and the number 42 would be encoded as: l4:spami42ee. Note the absence of separators between elements.
  • A dictionary is encoded as d<contents>e. The elements of the dictionary are encoded each key immediately followed by its value. All keys must be byte strings and must appear in lexicographical order. A dictionary that associates the values 42 and "spam" with the keys "foo" and "bar", respectively (in other words, {"bar": "spam", "foo": 42}), would be encoded as follows: d3:bar4:spam3:fooi42ee. (This might be easier to read by inserting some spaces: d 3:bar 4:spam 3:foo i42e e.)

There are no restrictions on what kind of values may be stored in lists and dictionaries; they may (and usually do) contain other lists and dictionaries. This allows for arbitrarily complex data structures to be encoded.

Features & drawbacks

Bencode is a very specialized kind of binary coding with some unique properties:

  • For each possible (complex) value, there is only a single valid bencoding; i.e. there is a bijection between values and their encodings. This has the advantage that applications may compare bencoded values by comparing their encoded forms, eliminating the need to decode the values.
  • Many BE codegroups can be decoded manually. Since the bencoded values often contain binary data, decoding may become quite complex. Bencode is not considered a human-readable encoding format.
  • Bencoding serves similar purposes as data languages like JSON and YAML, allowing complex yet loosely structured data to be stored in a platform independent way.

However, this uniqueness can cause some problems:

  • There are very few bencode editors[1]
  • Because bencoded files contain binary data, and because of some of the intricacies involved in the way binary strings are typically stored, it is often not safe to edit bencode files in text editors.

See also

References

  1. ^ "BEncode Editor". µTorrent Community Forums. Retrieved 24 October 2014.
Retrieved from "https://en.wikipedia.org/w/index.php?title=Bencode&oldid=744145289"