Method handleOf

app/src/DataModel/DataTable.cpp:372–381

* @brief Resolves (table, register) to a generation-tagged handle (gen<<24|index), or -1 if * unknown; run once off the hot path. Silent on miss: -1 is the documented sentinel and * probing for optional registers is a legitimate pattern, so (unlike get()) it does not * warn -- a typo surfaces through the name-based get() path instead. */

 *        warn -- a typo surfaces through the name-based get() path instead.
 */
qint64 DataModel::DataTableStore::handleOf(const QString& table, const QString& reg) const
{
  Q_ASSERT(m_initialized);

  const int idx = indexOf(table, reg);
  if (idx < 0) [[unlikely]]
    return -1;

  return (static_cast<qint64>(m_generation) << kHandleIndexBits) | static_cast<qint64>(idx);
}

/**
 * @brief Hot-path read by handle; a stale, out-of-range, or -1 handle is a safe nullptr.