Ausdruckssprache

Werten Sie dynamische Ausdrücke mit expr-lang-Syntax aus. Kompilieren und führen Sie sichere Ausdrücke für Filterung, Validierung und Regelauswertung ohne vollständige Lua-Ausführung aus.

Caching

expr.eval hält einen internen LRU-Cache kompilierter Ausdrücke (Standardkapazität 1000). Der Cache ist im Modul eingebaut und erfordert keine Konfiguration.

Laden

local expr = require("expr")

Caching

expr.eval hält intern einen LRU-Cache kompilierter Ausdrücke mit einer Standardkapazität von 1000. Der Cache ist in das Modul eingebaut und benötigt keine Konfiguration.

Ausdrücke auswerten

Werten Sie einen Ausdruck-String aus und geben Sie das Ergebnis zurück. Verwendet internen LRU-Cache für kompilierte Ausdrücke:

-- Simple math
local result, err = expr.eval("1 + 2 * 3")
if err then
    return nil, err
end
-- result == 7

-- With variables
local total, total_err = expr.eval("price * quantity", {
    price = 29.99,
    quantity = 3
})
if total_err then
    return nil, total_err
end
-- total == 89.97

-- Ternary operator
local label, label_err = expr.eval('score > 90 ? "A" : score > 80 ? "B" : "C"', {
    score = 85
})
if label_err then
    return nil, label_err
end
-- label == "B"

Gibt zurück: any, error

Ausdrücke kompilieren

Kompilieren Sie einen Ausdruck in ein wiederverwendbares Program für wiederholte Auswertungen:

-- Compile once for repeated use
local discount_calc, err = expr.compile("price * (1 - discount_rate)")
if err then
    return nil, err
end

-- Reuse with different inputs
local price1, run_err = discount_calc:run({price = 100, discount_rate = 0.1})
if run_err then
    return nil, run_err
end

local price2, second_run_err = discount_calc:run({price = 50, discount_rate = 0.2})
if second_run_err then
    return nil, second_run_err
end
-- price1 == 90 and price2 == 40

Gibt zurück: Program, error

Kompilierte Programme ausführen

Führen Sie einen kompilierten Ausdruck mit bereitgestellter Umgebung aus:

-- Validation rule
local validator, compile_err = expr.compile("len(password) >= 8 and len(password) <= 128")
if compile_err then
    return nil, compile_err
end

local valid, run_err = validator:run({password = "securepass123"})
if run_err then
    return nil, run_err
end
-- valid == true

-- Pricing rule
local pricer, pricing_compile_err = expr.compile([[
    base_price * quantity * (1 - bulk_discount) + shipping
]])
if pricing_compile_err then
    return nil, pricing_compile_err
end

local order_total, pricing_run_err = pricer:run({
    base_price = 25.00,
    quantity = 10,
    bulk_discount = 0.15,
    shipping = 12.50
})
if pricing_run_err then
    return nil, pricing_run_err
end
-- order_total == 225.00

Gibt zurück: any, error

Eingebaute Funktionen

Expr-lang enthält eingebaute Funktionen für häufige Operationen:

local maximum, max_err = expr.eval("max(1, 5, 3)")
if max_err then
    return nil, max_err
end

-- String-Funktionen
expr.eval('len("hello")')        -- 5
expr.eval('upper("hello")')      -- "HELLO"
expr.eval('lower("HELLO")')      -- "hello"
expr.eval('trim("  hi  ")')      -- "hi"
expr.eval('"hello" contains "ell"')  -- true

local total, sum_err = expr.eval("sum(values)", {values = {1, 2, 3, 4}})
if sum_err then
    return nil, sum_err
end
-- maximum == 5, uppercase == "HELLO", and total == 10

Weitere eingebaute Funktionen sind min, abs, ceil, floor, len, lower und trim. Expr-lang stellt außerdem Operatoren wie contains für Zeichenketten und in für Mitgliedschaftstests bereit.

Fehler

Siehe Fehlerbehandlung für die Arbeit mit Fehlern.