mirrors/valkey
1
0
Fork 0
mirror of http://github.com/valkey-io/valkey synced 2024-11-23 11:51:01 +00:00
Code Issues Packages Projects Releases Wiki Activity

updated zipmap documentation to match the implementation

Browse Source
This commit is contained in:
Pieter Noordhuis 2010-04-01 13:24:18 +02:00
parent 8c6700720d
commit bfded2aa51
1 changed files with 9 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
zipmap.c
View File

@ -42,10 +42,11 @@
/* Memory layout of a zipmap, for the map "foo" => "bar", "hello" => "world": /* Memory layout of a zipmap, for the map "foo" => "bar", "hello" => "world":
* *
* <status><len>"foo"<len><free>"bar"<len>"hello"<len><free>"world" * <zmlen><len>"foo"<len><free>"bar"<len>"hello"<len><free>"world"
* *
* <status> is 1 byte status. Currently only 1 bit is used: if the least * <zmlen> is 1 byte length that holds the current size of the zipmap.
* significant bit is set, it means the zipmap needs to be defragmented. * When the zipmap length is greater than or equal to 254, this value
* is not used and the zipmap needs to be traversed to find out the length.
* *
* <len> is the length of the following string (key or value). * <len> is the length of the following string (key or value).
* <len> lengths are encoded in a single value or in a 5 bytes value. * <len> lengths are encoded in a single value or in a 5 bytes value.
@ -62,22 +63,15 @@
* or even in order to add a key/value pair if it fits. * or even in order to add a key/value pair if it fits.
* *
* <free> is always an unsigned 8 bit number, because if after an * <free> is always an unsigned 8 bit number, because if after an
* update operation there are more than a few free bytes, they'll be converted * update operation there are more than a few free bytes, the zipmap will be
* into empty space prefixed by the special value 254. * reallocated to make sure it is as small as possible.
* *
* The most compact representation of the above two elements hash is actually: * The most compact representation of the above two elements hash is actually:
* *
* "\x00\x03foo\x03\x00bar\x05hello\x05\x00world\xff" * "\x02\x03foo\x03\x00bar\x05hello\x05\x00world\xff"
* *
* Empty space is marked using a 254 bytes + a <len> (coded as already * Note that because keys and values are prefixed length "objects",
* specified). The length includes the 254 bytes in the count and the * the lookup will take O(N) where N is the number of elements
* space taken by the <len> field. So for instance removing the "foo" key
* from the zipmap above will lead to the following representation:
*
* "\x00\xfd\x10........\x05hello\x05\x00world\xff"
*
* Note that because empty space, keys, values, are all prefixed length
* "objects", the lookup will take O(N) where N is the numeber of elements
* in the zipmap and *not* the number of bytes needed to represent the zipmap. * in the zipmap and *not* the number of bytes needed to represent the zipmap.
* This lowers the constant times considerably. * This lowers the constant times considerably.
*/ */