xxlang

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

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.

See benchmarks/RESULTS.md for detailed analysis.

License

MIT License