Conventions/code/naming

From Woozle Writes Code
Jump to navigation Jump to search

For now, this is just notes on conventions I want to use within the code.

Prefixes

Variable Prefixes

  • n: a count (int); use f for float
  • o: object
    • or: a ref object (see Value Types)
    • os: a status object (see Value Types)

Declaration Prefixes

  • c: class
  • cs: static class (not intended to be intantiable)
  • f: [DEPRECATED; use namespaces instead] ferreteria class/trait/interface
  • if: interface
  • t: trait

Value Types

  • cell means a direct value-reference
  • ref means a reference object (cReference)
  • slug means a string which can unambiguously represent any expected value or state of a given item
    • needed for representing record IDs in URLs, where one possible state is "new" (no ID yet)
  • status means a presence-info object
    • preferably descended from cThingHolder
  • unit means something that knows its own name and has awareness of its container-object/structure
    • preferably a PortRow Unit object
  • value means a read-only value, assumed to exist (throws error if not)