Create code for a BEAM module.

Extra information regarding the contents of a BEAM module.

Name and arity of a function that should be made public.

The Erlang compiler inserts two functions when compiling source files: module_info/0 and module_info/1. Some pieces of the Erlang toolchain expect this function to exist. For instance, the shell will crash if you try to use TAB (for auto-completion) on a BEAM module without these functions present. These functions have the same implementation, so you can use this Metadata to have the library generate and export them for you.

A virtual machine instruction—the main unit this library deals with. There are a finite number of instructions, enumerated in Codec.Beam.Instructions. Each new release of Erlang/OTP might introduce a few more and deprecate old ones.

A stack register. These are used to pass function arguments, and X 0 stores return values.

A stack register for saving values across function calls. Anything you put in a X register can be overwritten inside a function call (or inside a function call inside a function call). Y registers let you avoid that—they must be allocated and de-allocated though.

Floating point "register" for optimized floating point arithmetic. These are not treated as traditional stack registers.

The empty list.

Mark a spot in the code, so that you can jump to it with a function or condition. Start with Label 1 and go up from there.

Erlang literals, stored on the heap.

Turn a named function into a fun, for use with make_fun2.

Reference a function from another module. For example, Import "array" "map" 2 refers to the stdlib function: array:map/2.

Either type of stack register, X or Y. Instructions that work with this type, use IsRegister for convenience.

Any sort of Erlang value. Instructions that work with this type, use IsSource for convenience. Note the IsSource instance for Text, which represents a stack atom (in contrast with the Atom constructor in Literal, which is heap-stored).

Memory for manipulating F, for use with fmove. Instructions that work with this type, use IsRegisterF for convenience.

Something that can be coerced into F, for use with fmove. Instructions that work with this type, use IsSourceF for convenience.

Convert BIF to a normal import with zero arguments, which can be used with call and friends.

Convert BIF to a normal import with one argument.

Convert BIF to a normal import with two arguments.

Convert BIF to a normal import with three arguments.

Convert BIF to a normal import with four arguments.