bdlc.txt

@PURPOSE: Provide container vocabulary types.

@MNEMONIC: Basic Development Library Container (bdlc)

@DESCRIPTION: The 'bdlc' ("Basic Development Library Container") package
 provides container vocabulary types.

/Hierarchical Synopsis
/---------------------
 The 'bdlc' package currently has 11 components having 3 levels of physical
 dependency.  The list below shows the hierarchical ordering of the components.
 The order of components within each level is not architecturally significant,
 just alphabetical.
..
  3. bdlc_flathashmap
     bdlc_flathashset

  2. bdlc_compactedarray
     bdlc_flathashtable
     bdlc_packedintarrayutil

  1. bdlc_bitarray
     bdlc_flathashtable_groupcontrol                                  !PRIVATE!
     bdlc_hashtable
     bdlc_indexclerk
     bdlc_packedintarray
     bdlc_queue                                          !DEPRECATED!
..

/Component Synopsis
/------------------
: 'bdlc_bitarray':
:      Provide a space-efficient, sequential container of boolean values.
:
: 'bdlc_compactedarray':
:      Provide a compacted array of 'const' user-defined objects.
:
: 'bdlc_flathashmap':
:      Provide an open-addressed unordered map container.
:
: 'bdlc_flathashset':
:      Provide an open-addressed unordered set container.
:
: 'bdlc_flathashtable':
:      Provide an open-addressed hash table like Abseil 'flat_hash_map'.
:
: 'bdlc_flathashtable_groupcontrol':                                  !PRIVATE!
:      Provide inquiries to a flat hash table group of control values.
:
: 'bdlc_hashtable':
:      Provide a double-hashed table with utility.
:
: 'bdlc_indexclerk':
:      Provide a manager of reusable, non-negative integer indices.
:
: 'bdlc_packedintarray':
:      Provide an extensible, packed array of integral values.
:
: 'bdlc_packedintarrayutil':
:      Provide common non-primitive operations on 'bdlc::PackedIntArray'.
:
: 'bdlc_queue':                                          !DEPRECATED!
:      Provide an in-place double-ended queue of 'T' values.