Class: Erlang::ETF::NewReference

Inherits:
Object
  • Object
show all
Includes:
Term
Defined in:
lib/erlang/etf/new_reference.rb

Overview

1 2 N 1 N'
114 Len Node Creation ID ...

Node and Creation are as in REFERENCE_EXT.

ID contains a sequence of big-endian unsigned integers (4 bytes each, so N' is a multiple of 4), but should be regarded as uninterpreted data.

N' = 4 * Len.

In the first word (four bytes) of ID, only 18 bits are significant, the rest should be 0. In Creation, only 2 bits are significant, the rest should be 0.

NEW_REFERENCE_EXT was introduced with distribution version 4. In version 4, N' should be at most 12.

See REFERENCE_EXT).

(see NEW_REFERENCE_EXT)

Constant Summary collapse

UINT8 = 
Erlang::ETF::Term::UINT8
UINT16BE = 
Erlang::ETF::Term::UINT16BE
UINT32BE = 
Erlang::ETF::Term::UINT32BE

Constants included from Term

Term::ATOM_CACHE_REF, Term::ATOM_EXT, Term::ATOM_INTERNAL_REF2, Term::ATOM_INTERNAL_REF3, Term::ATOM_UTF8_EXT, Term::BINARY_ENCODING, Term::BINARY_EXT, Term::BINARY_INTERNAL_REF, Term::BIT_BINARY_EXT, Term::BIT_BINARY_INTERNAL_REF, Term::COMPRESSED, Term::DIST_HEADER, Term::DOUBLE, Term::DOUBLEBE, Term::DOUBLELE, Term::ERLANG_MAGIC_BYTE, Term::EXPORT_EXT, Term::FLOAT_EXT, Term::FUN_EXT, Term::INT128, Term::INT128BE, Term::INT128LE, Term::INT16, Term::INT16BE, Term::INT16LE, Term::INT32, Term::INT32BE, Term::INT32LE, Term::INT64, Term::INT64BE, Term::INT64LE, Term::INT8, Term::INTEGER_EXT, Term::LARGE_BIG_EXT, Term::LARGE_TUPLE_EXT, Term::LIST_EXT, Term::MAP_EXT, Term::NEW_FLOAT_EXT, Term::NEW_FUN_EXT, Term::NEW_REFERENCE_EXT, Term::NIL_EXT, Term::PID_EXT, Term::PORT_EXT, Term::REFERENCE_EXT, Term::SINGLE, Term::SINGLEBE, Term::SINGLELE, Term::SMALL_ATOM_EXT, Term::SMALL_ATOM_UTF8_EXT, Term::SMALL_BIG_EXT, Term::SMALL_INTEGER_EXT, Term::SMALL_TUPLE_EXT, Term::STRING_EXT, Term::UINT128, Term::UINT128BE, Term::UINT128LE, Term::UINT16, Term::UINT16LE, Term::UINT32, Term::UINT32LE, Term::UINT64, Term::UINT64BE, Term::UINT64LE

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Term

#<=>, binary_encoding, #eql?, #erlang_external_type, #hash, included, #to_erlang_etf

Constructor Details

#initialize(term, node = nil, creation = nil, ids = nil) ⇒ NewReference

Returns a new instance of NewReference.

Raises:

  • (ArgumentError) 


52
53
54
55
56
57
58
 
# File 'lib/erlang/etf/new_reference.rb', line 52

def initialize(term, node = nil, creation = nil, ids = nil)
  raise ArgumentError, "term must be of type Erlang::Reference" if not term.kind_of?(Erlang::Reference) or not term.new_reference?
  @term     = term
  @node     = node
  @creation = creation
  @ids      = ids
end

Class Method Details

.[](term, node = nil, creation = nil, ids = nil) ⇒ Object 



39
40
41
 
# File 'lib/erlang/etf/new_reference.rb', line 39

def [](term, node = nil, creation = nil, ids = nil)
  return new(term, node, creation, ids)
end

.erlang_load(buffer) ⇒ Object 



43
44
45
46
47
48
49
 
# File 'lib/erlang/etf/new_reference.rb', line 43

def erlang_load(buffer)
  length, = buffer.read(2).unpack(UINT16BE)
  node = Erlang::ETF.read_term(buffer)
  creation, *ids = buffer.read(1 + (4 * length)).unpack("#{UINT8}#{UINT32BE}#{length}")
  term = Erlang::Reference[Erlang.from(node), Erlang.from(creation), Erlang.from(ids)]
  return new(term, node, creation, ids)
end

Instance Method Details

#erlang_dump(buffer = ::String.new.force_encoding(BINARY_ENCODING)) ⇒ Object 



60
61
62
63
64
65
66
67
68
69
70
71
 
# File 'lib/erlang/etf/new_reference.rb', line 60

def erlang_dump(buffer = ::String.new.force_encoding(BINARY_ENCODING))
  buffer << NEW_REFERENCE_EXT
  ids = @ids || @term.ids
  length = ids.size
  buffer << [length].pack(UINT16BE)
  Erlang::ETF.write_term(@node || @term.node, buffer)
  buffer << [
    @creation || @term.creation,
    *ids
  ].pack("#{UINT8}#{UINT32BE}#{length}")
  return buffer
end

#inspect ⇒ Object 



73
74
75
76
77
78
79
 
# File 'lib/erlang/etf/new_reference.rb', line 73

def inspect
  if @node.nil? and @creation.nil? and @ids.nil?
    return super
  else
    return "#{self.class}[#{@term.inspect}, #{@node.inspect}, #{@creation.inspect}, #{@ids.inspect}]"
  end
end

#pretty_print(pp) ⇒ Object 



81
82
83
84
85
86
87
88
 
# File 'lib/erlang/etf/new_reference.rb', line 81

def pretty_print(pp)
  state = [@term]
  state.push(@node, @creation, @ids) if not @node.nil? or not @creation.nil? or not @ids.nil?
  return pp.group(1, "#{self.class}[", "]") do
    pp.breakable ''
    pp.seplist(state) { |obj| obj.pretty_print(pp) }
  end
end