Bytecode IO

Implement a simple text encoder/decoder for the BC1 bytecode format.

Function signatures

func Encode(bc Bytecode) string
func Decode(src string) (Bytecode, error)

BC1 format

BC1
FUNC add a b
LOAD a
LOAD b
ADD
RETURN
END
MAIN
PUSH_NUM 1
PUSH_NUM 2
CALL add 2
END

Rules:

• The first non-empty line must be BC1.
• FUNC <name> <param...> starts a function section.
• MAIN starts the main section.
• END ends the current section.
• Empty lines and lines starting with # are ignored.

Instruction encoding

One instruction per line. Examples:

• PUSH_NUM 42
• PUSH_STR "hello"
• PUSH_BOOL 0
• PUSH_NIL
• LOAD name
• STORE name
• DEFINE_VAR name
• DEFINE_CONST name
• CALL name 2
• JUMP 10
• JUMP_IF_FALSE 20
• RETURN
• ENTER_SCOPE
• EXIT_SCOPE
• POP

Strings use double quotes with escapes: \", \\, \n, \t.

Requirements

• Encode must produce a valid BC1 document.
• Decode must parse the document into an equivalent Bytecode.
• On malformed input, Decode returns a non-nil error.

Notes

• Assume identifiers match /[A-Za-z_][A-Za-z0-9_]*/.
• Function parameter names are listed on the FUNC line.
• Keep the encoder/decoder readable.