Aiagent at 16:27, 25 August 2025

2025-08-25T16:27:51Z

← Older revision		Revision as of 18:27, 25 August 2025
Line 1:		Line 1:
	= SCM Builtins =		= SCM Builtins =

			The '''SCM Builtins''' module provides the core foundational functions for the SCM (Scheme) programming language implementation. These built-in functions handle essential operations including:

			* '''Language constructs''': Control flow (if, and, or), variable management (define, set), and code evaluation (eval, quote)
			* '''Function operations''': Lambda creation, function application, and error handling (try, error)
			* '''Data manipulation''': Type conversion (string, symbol), list operations, and pattern matching
			* '''Development tools''': Code optimization, timing measurements, and debugging support
			* '''Execution control''': Parallel processing, variable scoping, and source code annotation

			This module forms the foundation upon which all other SCM functionality is built, providing the essential primitives needed for Scheme programming.

			← Back to [[Full SCM API documentation]]

	== quote ==		== quote ==

Aiagent at 16:24, 25 August 2025

2025-08-25T16:24:34Z

Show changes

Aiagent at 16:21, 25 August 2025

2025-08-25T16:21:56Z

Show changes

Aiagent: Created page with "# SCM Builtins ## quote returns a symbol or list without evaluating it Allowed number of parameters: 1–1 ### Parameters - symbol (`symbol`): symbol to quote ### Returns `symbol` ## eval executes the given scheme program in the current environment Allowed number of parameters: 1–1 ### Parameters - code (`list`): list with head and optional parameters ### Returns `any` ## size compute the memory size of a value **Allowed number of param..."

2025-08-25T16:16:45Z

Created page with "# SCM Builtins ## quote returns a symbol or list without evaluating it **Allowed number of parameters:** 1–1 ### Parameters - **symbol** (`symbol`): symbol to quote ### Returns `symbol` ## eval executes the given scheme program in the current environment **Allowed number of parameters:** 1–1 ### Parameters - **code** (`list`): list with head and optional parameters ### Returns `any` ## size compute the memory size of a value **Allowed number of param..."

New page

# SCM Builtins

## quote

returns a symbol or list without evaluating it

**Allowed number of parameters:** 1–1

### Parameters

- **symbol** (`symbol`): symbol to quote

### Returns

`symbol`

## eval

executes the given scheme program in the current environment

**Allowed number of parameters:** 1–1

### Parameters

- **code** (`list`): list with head and optional parameters

### Returns

`any`

## size

compute the memory size of a value

**Allowed number of parameters:** 1–1

### Parameters

- **value** (`any`): value to examine

### Returns

`int`

## optimize

optimize the given scheme program

**Allowed number of parameters:** 1–1

### Parameters

- **code** (`list`): list with head and optional parameters

### Returns

`any`

## time

measures the time it takes to compute the first argument

**Allowed number of parameters:** 1–2

### Parameters

- **code** (`any`): code to execute
- **label** (`string`): label to print in the log or trace

### Returns

`any`

## if

checks a condition and then conditionally evaluates code branches; there might be multiple condition+true-branch clauses

**Allowed number of parameters:** 2–1000

### Parameters

- **condition...** (`bool`): condition to evaluate
- **true-branch...** (`returntype`): code to evaluate if condition is true
- **false-branch** (`returntype`): code to evaluate if condition is false

### Returns

`returntype`

## and

returns true if all conditions evaluate to true

**Allowed number of parameters:** 1–1000

### Parameters

- **condition** (`bool`): condition to evaluate

### Returns

`bool`

## or

returns true if at least one condition evaluates to true

**Allowed number of parameters:** 1–1000

### Parameters

- **condition** (`any`): condition to evaluate

### Returns

`bool`

## coalesce

returns the first value that has a non-zero value

**Allowed number of parameters:** 1–1000

### Parameters

- **value** (`returntype`): value to examine

### Returns

`returntype`

## coalesceNil

returns the first value that has a non-nil value

**Allowed number of parameters:** 1–1000

### Parameters

- **value** (`returntype`): value to examine

### Returns

`returntype`

## define

defines or sets a variable in the current environment

**Allowed number of parameters:** 2–2

### Parameters

- **variable** (`symbol`): variable to set
- **value** (`returntype`): value to set the variable to

### Returns

`bool`

## set

defines or sets a variable in the current environment

**Allowed number of parameters:** 2–2

### Parameters

- **variable** (`symbol`): variable to set
- **value** (`returntype`): value to set the variable to

### Returns

`bool`

## error

halts the whole execution thread and throws an error message

**Allowed number of parameters:** 1–1000

### Parameters

- **value...** (`any`): value or message to throw

### Returns

`string`

## try

tries to execute a function and returns its result. In case of a failure, the error is fed to the second function and its result value will be used

**Allowed number of parameters:** 2–2

### Parameters

- **func** (`func`): function with no parameters that will be called
- **errorhandler** (`func`): function that takes the error as parameter

### Returns

`any`

## apply

runs the function with its arguments

**Allowed number of parameters:** 2–2

### Parameters

- **function** (`func`): function to execute
- **arguments** (`list`): list of arguments to apply

### Returns

`any`

## apply_assoc

runs the function with its arguments but arguments is a assoc list

**Allowed number of parameters:** 2–2

### Parameters

- **function** (`func`): function to execute (must be a lambda)
- **arguments** (`list`): assoc list of arguments to apply

### Returns

`symbol`

## symbol

returns a symbol built from that string

**Allowed number of parameters:** 1–1

### Parameters

- **value** (`string`): string value that will be converted into a symbol

### Returns

`symbol`

## list

returns a list containing the parameters as alements

**Allowed number of parameters:** 0–10000

### Parameters

- **value...** (`any`): value for the list

### Returns

`list`

## string

converts the given value into string

**Allowed number of parameters:** 1–1

### Parameters

- **value** (`any`): any value

### Returns

`string`

## match

takes a value evaluates the branch that first matches the given pattern
Patterns can be any of:
- symbol matches any value and stores is into a variable
- "string" (matches only this string)
- number (matches only this value)
- (symbol "something") will only match the symbol 'something'
- '(subpattern subpattern...) matches a list with exactly these subpatterns
- (concat str1 str2 str3) will decompose a string into one of the following patterns: "prefix" variable, variable "postfix", variable "infix" variable
- (cons a b) will reverse the cons function, so it will match the head of the list with a and the rest with b
- (regex "pattern" text var1 var2...) will match the given regex pattern, store the whole string into text and all capture groups into var1, var2...

**Allowed number of parameters:** 3–10000

### Parameters

- **value** (`any`): value to evaluate
- **pattern...** (`any`): pattern
- **result...** (`returntype`): result value when the pattern matches; this code can use the variables matched in the pattern
- **default** (`any`): (optional) value that is returned when no pattern matches

### Returns

`any`

## lambda

returns a function (func) constructed from the given code

**Allowed number of parameters:** 2–3

### Parameters

- **parameters** (`symbol|list|nil`): if you provide a parameter list, you will have named parameters. If you provide a single symbol, the list of parameters will be provided in that symbol
- **code** (`any`): value that is evaluated when the lambda is called. code can use the parameters provided in the declaration as well es the scope above
- **numvars** (`number`): number of unnamed variables that can be accessed via (var 0) (var 1) etc.

### Returns

`func`

## begin

creates a own variable scope, evaluates all sub expressions and returns the result of the last one

**Allowed number of parameters:** 0–10000

### Parameters

- **expression...** (`any`): expressions to evaluate

### Returns

`any`

## parallel

executes all parameters in parallel and returns nil if they are finished

**Allowed number of parameters:** 1–10000

### Parameters

- **expression...** (`any`): expressions to evaluate in parallel

### Returns

`any`

## source

annotates the node with filename and line information for better backtraces

**Allowed number of parameters:** 4–4

### Parameters

- **filename** (`string`): Filename of the code
- **line** (`number`): Line of the code
- **column** (`number`): Column of the code
- **code** (`returntype`): code

### Returns

`returntype`

## scheme

parses a scheme expression into a list

**Allowed number of parameters:** 1–2

### Parameters

- **code** (`string`): Scheme code
- **filename** (`string`): optional filename

### Returns

`any`

## serialize

serializes a piece of code into a (hopefully) reparsable string; you shall be able to send that code over network and reparse with (scheme)

**Allowed number of parameters:** 1–1

### Parameters

- **code** (`list`): Scheme code

### Returns

`string`

SCM Builtins - Revision history

Aiagent at 16:27, 25 August 2025

Aiagent at 16:24, 25 August 2025

Aiagent at 16:21, 25 August 2025