النواة والتأثيرات
كل عامل يستطيع برنامج .lolo استدعاءه، من السجل المعتمد الذي يضمّنه المترجم.
نطاقات الأسماء في هذه الصفحة: /.
النواة
!=
Not equal to
(!= a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | any | First value |
b | any | Second value |
القيمة المعادة: boolean
مثال
(!= 5 3) // => true%
Modulo (remainder)
(% a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | number | Dividend |
b | number | Divisor |
القيمة المعادة: number
مثال
(% 10 3) // => 1*
Multiply numbers
(* a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | number | First number |
b | number | Second number (variadic) |
القيمة المعادة: number
مثال
(* 3 4) // => 12+
Add numbers
(+ a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | number | First number |
b | number | Second number (variadic) |
القيمة المعادة: number
مثال
(+ 2 3) // => 5-
Subtract or negate
(- a)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | number | Number (variadic) |
القيمة المعادة: number
مثال
(- 5) // => -5/
Divide numbers
(/ a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | number | Dividend |
b | number | Divisor |
القيمة المعادة: number
مثال
(/ 10 2) // => 5<
Less than
(< a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | number | First number |
b | number | Second number |
القيمة المعادة: boolean
مثال
(< 3 5) // => true<=
Less than or equal
(<= a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | number | First number |
b | number | Second number |
القيمة المعادة: boolean
مثال
(<= 5 5) // => true=
Equal to
(= a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | any | First value |
b | any | Second value |
القيمة المعادة: boolean
مثال
(= 5 5) // => true==
Equal to (canonical .lolo spelling)
(== a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | any | First value |
b | any | Second value |
القيمة المعادة: boolean
مثال
(== 5 5) // => true>
Greater than
(> a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | number | First number |
b | number | Second number |
القيمة المعادة: boolean
مثال
(> 5 3) // => true>=
Greater than or equal
(>= a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | number | First number |
b | number | Second number |
القيمة المعادة: boolean
مثال
(>= 5 5) // => trueand
Logical AND (returns the last truthy value, NOT a boolean — short-circuit)
(and a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | boolean | First condition |
b | boolean | Second condition (variadic) |
القيمة المعادة: boolean
مثال
(and true true) // => trueatomic
Run effects as one server transaction: all succeed or all roll back
(atomic effects)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
effects | {'kind': 'sexpr'} | The effects to group |
القيمة المعادة: void · يعمل على: server
مثال
(atomic (set @entity.x 10) (set @entity.y 20))call-service
Invoke an external service action. Optional trailing { emit: { success, failure } } options object attaches closed-circuit emit routing (V2 frame contract).
(call-service service action)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
service | string | Service name |
action | string | Action name (variadic) |
القيمة المعادة: void · يعمل على: server
مثال
(call-service "email" "send")deref
Snapshot read of a binding or entity, without subscribing to changes
(deref target options)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
target | string | A binding (@entity.health) or entity name |
options | {'kind': 'object', 'fields': {'id': 'string', 'filter': 'any', 'include': {'kind': 'array', 'of': 'string'}}, 'open': True} | Selector: id | filter | include |
القيمة المعادة: any · يعمل على: any
مثال
(deref @entity.health)despawn
Despawn an entity instance (games)
(despawn entityId)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
entityId | string | Target entity id (defaults to @entity.id) |
القيمة المعادة: void · يعمل على: any
مثال
(despawn)do
Sequential execution of multiple effects/expressions
(do expr)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
expr | any | Expression (variadic) |
القيمة المعادة: any
مثال
(do (emit "DO_A") (emit "DO_B"))emit
Emit an event onto the bus
(emit event)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
event | string | Event key (optional payload follows) |
القيمة المعادة: void · يعمل على: any
مثال
(emit "DO_UPDATE")evaluate
Evaluate a model against test cases (ML effect)
(evaluate model)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
model | object | Model to evaluate |
القيمة المعادة: object
مثال
(evaluate {"layers":[{"type":"dense","units":2}]} [{"input":[0],"expected":[1]}])fetch
Fetch an entity (by id) or a collection (by filter) from persistence
(fetch query)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
query | any | Entity ID or filter |
القيمة المعادة: void · يعمل على: server
مثال
(fetch "Task" {"id":"t1","emit":{"success":"TASK_LOADED"}})fetch-stream
Stream an LLM or HTTP response, emitting on_message per chunk, success on completion, failure on error
(fetch-stream url)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
url | string | Endpoint URL |
القيمة المعادة: void · يعمل على: server
مثال
(fetch-stream "https://api.example.com/stream")fn
Lambda expression (used for per-item renders and transforms)
(fn param body)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
param | string | Parameter name |
body | any | Lambda body |
القيمة المعادة: function
مثال
(fn x (> @x.price 100))forward
Run a forward pass through a model (ML effect)
(forward model input)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
model | object | Neural network model |
input | object | Input tensor |
القيمة المعادة: tensor
مثال
(forward {"layers":[{"type":"dense","units":2}]} [0.5])if
Conditional expression (ternary). Return type is union of branch types.
(if cond a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
cond | boolean | Condition to evaluate |
a | any | Value if true |
b | any | Value if false |
القيمة المعادة: any
مثال
(if true 42 0) // => 42let
Bind local variables for a body expression
(let bindings body)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
bindings | array | Variable binding pairs |
body | any | Expression using bindings |
القيمة المعادة: any
مثال
(let [["x",10]] ["+","x",1]) // => 15list
Literal array constructor — evaluates each argument and returns them as an array. Lowering wraps a literal list bound for a literal-array slot in list so it is unambiguously data, never a call (disambiguates a list whose first element collides with an operator name, e.g. [path method …]).
(list ...items)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
...items | {'kind': 'sexpr'} | Items to collect into a literal array |
القيمة المعادة: array
مثال
(list 1 2 3) // => [1 2 3]log
Emit a structured info log line (compiled + runtime)
(log value)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
value | any | Value to log |
القيمة المعادة: void · يعمل على: any
مثال
(log "User signed in")navigate
Navigate to a route: (navigate path payload? options?) — options carries { crumb } labelling the navigation-stack entry for the target page
(navigate path)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
path | string | Route path |
القيمة المعادة: void · يعمل على: client
مثال
(navigate "/dashboard")navigate-back
Pop the orbital-scoped navigation stack and return to the previous entry
(navigate-back)القيمة المعادة: void · يعمل على: client
مثال
(navigate-back)not
Logical NOT
(not value)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
value | boolean | Boolean value |
القيمة المعادة: boolean
مثال
(not true) // => falsenotify
Show a notification (in-app, email, push, sms)
(notify message)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
message | string | Notification message (variadic) |
القيمة المعادة: void · يعمل على: any
مثال
(notify "Hello!")or
Logical OR (returns the first truthy value, NOT a boolean — short-circuit)
(or a b)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
a | boolean | First value |
b | boolean | Second value (variadic) |
القيمة المعادة: boolean
مثال
(or false true) // => truepath
Build a dot-separated path string from segments. Used with set effect for dynamic field paths.
(path segment)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
segment | string | Path segment (variadic) |
القيمة المعادة: string
مثال
(path "user" "id" "name") // => "user.id.name"persist
Create, update, delete, clear, or batch entity records. Optional trailing { emit: { success, failure } } options object attaches closed-circuit emit routing.
(persist operation entity)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
operation | string | Operation type |
entity | entity | Entity data (variadic) |
القيمة المعادة: void · يعمل على: server
مثال
(persist "create" "Task" {"title":"Buy milk"} {"emit":{"success":"TASK_CREATED"}})ref
Reactive entity reference (deprecated, use fetch with listens in V2)
(ref entity)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
entity | string | Entity reference (variadic) |
القيمة المعادة: void · يعمل على: any
مثال
(ref "Task")render-ui
Render a pattern into a UI slot
(render-ui pattern slot)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
pattern | string | Pattern name |
slot | string | Slot name (variadic) |
القيمة المعادة: void · يعمل على: client
مثال
(render-ui "button" "primary-slot")send-server
Send an orbital event to the server over WebSocket (client-side; chat/real-time trigger)
(send-server event)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
event | string | Event name (variadic) |
القيمة المعادة: void · يعمل على: client
مثال
(send-server "CHAT_MESSAGE")set
Set a binding to a value
(set binding value)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
binding | string | Variable name |
value | any | Value to set |
القيمة المعادة: void · يعمل على: any
مثال
(set "count" 42)spawn
Spawn a new entity instance (games)
(spawn entity)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
entity | entity | Entity to spawn (variadic) |
القيمة المعادة: void · يعمل على: any
مثال
(spawn "Bullet" {"x":10,"y":20})swap
Atomic compare-and-swap of an entity field on the server
(swap target update)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
target | {'kind': 'binding'} | The field to swap (@entity.counter) |
update | {'kind': 'sexpr'} | The new value, computed from the current one |
القيمة المعادة: void · يعمل على: server
مثال
(swap @entity.counter (+ @entity.counter 1))train
Train a model over a dataset (ML effect)
(train dataset)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
dataset | array | Training dataset |
القيمة المعادة: object · يعمل على: any
مثال
(train {"layers":[{"type":"dense","units":2}]} [[0,1],[1,0]] {"epochs":100})watch
Emit an event whenever a watched binding changes
(watch target event options)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
target | {'kind': 'binding'} | The binding to watch |
event | {'kind': 'eventKey'} | Event emitted on each change |
options | {'kind': 'object', 'fields': {'debounce': 'number', 'emit': {'kind': 'object', 'fields': {}, 'open': True}}, 'open': False} | debounce (ms) | emit |
القيمة المعادة: void · يعمل على: any
مثال
(watch @entity.status "STATUS_UPDATED" {"debounce":100})when
Conditional effect without an else branch
(when condition effect)المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
condition | any | Condition to test |
effect | lambda | Effect to execute |
القيمة المعادة: void
مثال
(when true (fn x (log "fired")))