term.reference

Erlang references.

class term.reference.Reference(node_name, creation, refid)

Bases: BaseRef

Represents a reference value from Erlang, typically it has 12 bytes of unique data, but it might change.

static create(node_name, creation)

A new reference of node node_name, unequal to every other reference this process creates.

Its 3 ID words hold a per-process counter (the low 18 bits in the first word, the next 32 in the second) and 32 random bits (third), so a restarted node is unlikely to repeat references it made before.

Parameters:
  • node_name (str) – string, not a Node object

  • creation (int) – the creation of the node’s distribution

Return type:

term.reference.Reference

node_name_

Node the ref comes from. NOTE: native codec assumes this is a string.

id_

Identification bytes, guaranteed to be unique on the creating node

equals(other)

True if other is the same reference: node, creation and id.