Frequently Asked Questions

What is Matchbox?

Matchbox is a programming language that compiles and runs .mb source files.

What file extension does Matchbox use?

Matchbox source files use the .mb extension.

How do I run a source file?

From the file's directory, run:

matchbox main.mb

How do I check the installed version?

Run:

matchbox --version

The output reports the installed Matchbox version. For this documentation, use a Matchbox 0.2 patch release.

Where should a new user begin?

Start with the Beginner's Guide, then continue to Language Basics.

Where are built-in functions documented?

The Built-in Functions reference lists all built-in functions grouped by category.

Where can I learn how Matchbox works internally?

See Matchbox Internals for source processing, compiler, bytecode, and virtual machine notes. For the broader goals and design principles, see Project Direction.

Can a program read input or command-line arguments?

No. Matchbox 0.2 programs cannot read standard input, files, environment variables, or command-line arguments.

Does Matchbox support conditions or loops?

No. Words and tokens for some future control-flow features are reserved, but conditionals and loops are not implemented in 0.2.

Why is a function reported as undefined?

Functions must be defined before they are called. Direct recursion is not supported because a function's name is not available inside its own definition.

Where can I find known limitations?

See Current Limitations.