Ferreteria/v0.6/clade/Sys/Data/Things/Array

clade: Sys\Data\Things\Array

Clade Family
StandardBase (c,i) Keyed (i,t) Series (i,t) Whole (i,t)	→ Array	→ DStor → QStor

About

Concepts

• An Array is always a Series (i.e. it retains order), but a Series is not necessarily an Array. (It could be more like a stream.)
• An Array always has a key, but sometimes the key is just a sequential number. A Keyed array is an Array with assigned key-values.
• (not implemented) A Flags[et] is a collection of boolean values, i.e. predefined items which are either present or absent
  • It probably makes more sense to just implement these as integer constants defined with binary values, rather than a clade... unless you want a user-friendly readout? To be explored.
• (not implemented) An enum is a fixed set of values, and can represent each of those values individually. A wrapper for this could provide additional services not permitted by PHP's enum implementaton.

Clade structure

subject to revision while I think through the concepts (2025-08-16)

• Array: clade which consolidates all the array-type interfaces and code
• Array-type interfaces & code (traits) which go into Array:
  • Keyed
  • Series
  • Whole
• ARoot: tentatively, this stuff should all be in Array.
• To be explained:
  • DStor stuff:
    • interfaces:
      • Keyed
      • Series
      • Whole
    • podlings:
      • AStr
      • Pieces
        • Row
  • QStor stuff:
    • interfaces:
      • Keyed
      • Series
      • Whole
    • podlings:
      • AObj
      • Fields

History

• 2025-08-15 I keep getting muddled about how this is supposed to work, and therefore writing problematic code -- so, finally mapping it out conceptually.