contrib/file_stack/format.txt

   1 A file-based stack:
   2 ===================
   3
   4 This is the format for a file-based stack which works as any Stackable class.
   5
   6 General made up:
   7
   8 Purpose: | "magic"   | separator | count    | position      | separator |
   9 ---------+-----------+-----------+----------+---------------+-----------+
  10 Bytes:   | 9         | 1         | 20 (hex) | 2 - n^2 (hex) | 1         |
  11 ---------+-----------+-----------+----------+---------------+-----------+
  12 Example: | STACKv1.0 |    ???    | 0...ff   | 01            |    ???    |
  13
  14 Continued:
  15
  16 Purpose: | name 0 | entry 0    | separator | name 1 | entry 1    | separator | name n | entry n    | EOF |
  17 ---------+--------+------------+-----------+--------+------------+-----------+--------+------------+-----+
  18 Bytes:   | 10     | 1-n (pack) | 1         | 10     | 1-n (pack) | 1         | 10     | 1-n (pack) | 1   |
  19 ---------+--------+------------+-----------+--------+------------+-----------+--------+------------+-----+
  20 Example: | foo    |     ...    |    ???    | bar    |     ...    |    ???    | bar    |     ...    | EOF |