xxlang

README

Xxlang

中文文档

Xxlang (Chinese: 现象语言) is a bytecode VM-based scripting language implemented in Go.

Features

• Bytecode VM - Efficient execution with a stack-based virtual machine
• Closures - First-class functions with proper closure support
• Classes & OOP - Object-oriented programming with inheritance
• Module System - Import/export with standard library
• Rich Built-ins - 41+ built-in functions for string, math, array, and map operations
• REPL - Interactive REPL with multi-line support and persistent state
• Embeddable - Can be used as a library in other Go projects
• Compilable - Compile to standalone executable or bytecode

Documentation

• Language Reference - Complete language syntax and features
• Standard Library - Built-in modules and functions
• Embedding Guide - Using Xxlang in Go applications
• Performance Benchmarks - Performance analysis

Installation

go install github.com/topxeq/xxlang/cmd/xxlang@latest

Quick Start

# Run a file
xxlang run script.xxl

# Start interactive REPL
xxlang

# Compile to executable
xxlang compile -o program script.xxl

Language Examples

Variables and Types

var x = 10
var y = 3.14
var name = "hello"
var arr = [1, 2, 3, 4, 5]
var map = {"a": 1, "b": 2}

Functions and Closures

func add(a, b) {
    return a + b
}

func makeCounter() {
    var count = 0
    func() {
        count = count + 1
        return count
    }
}

var counter = makeCounter()
println(counter())  // 1
println(counter())  // 2

Classes and OOP

class Point {
    func init(x, y) {
        this.x = x
        this.y = y
    }

    func add(other) {
        return new Point(this.x + other.x, this.y + other.y)
    }
}

var p1 = new Point(1, 2)
var p2 = new Point(3, 4)
var p3 = p1.add(p2)

Control Flow

// If-else
if (x > 0) {
    println("positive")
} else {
    println("non-positive")
}

// For loop
for (var i = 0; i < 5; i = i + 1) {
    println(i)
}

// For-in loop
for (item in [1, 2, 3]) {
    println(item)
}

Modules

// Import standard library
import "std/math"
println(math.sqrt(16))

// Import specific functions
import "std/io" { readFile, writeFile }

Built-in Functions

String Functions

upper("hello")              // "HELLO"
lower("HELLO")              // "hello"
split("a,b,c", ",")         // ["a", "b", "c"]
containsStr("hello", "ell") // true

Math Functions

sqrt(16)    // 4
pow(2, 10)  // 1024
abs(-42)    // 42
floor(3.7)  // 3
ceil(3.2)   // 4

Array Functions

sort([3, 1, 2])    // [1, 2, 3]
sum([1, 2, 3])      // 6
reverse([1, 2, 3])  // [3, 2, 1]
push([1, 2], 3)     // [1, 2, 3]

CLI Commands

xxlang                   # Start REPL
xxlang run file.xxl      # Run script
xxlang compile file.xxl  # Compile to executable
xxlang version           # Show version
xxlang help              # Show help

REPL Commands

Command	Description
exit, quit	Exit the REPL
help	Show help message
history	Show command history
clear	Clear all variables and functions

Building from Source

git clone https://github.com/topxeq/xxlang.git
cd xxlang
go build -o xxlang ./cmd/xxlang

Running Tests

go test ./...

Performance

Xxlang uses a bytecode VM with tail call optimization.

Language	fib(35) Time	Relative to Go
Go	0.056s	1x
Python	2.77s	49x
Xxlang	9.37s	167x

See benchmarks/RESULTS.md for detailed analysis.

License

MIT License