std-caja-lib

Welcome to std-caja-lib, the standard library for the Caja programming language. This repository provides a collection of essential utility functions designed to make writing Caja code more expressive and functional, focusing on iteration, state management, and collections.

Functions in index.caja

Here is a breakdown of the functions provided in this module:

forEach<T>(arr: [T], procedure: fn(T) -> T) -> Nothing

Iterates over each element in an array arr and applies the given procedure function to it. This function performs a standard loop over array elements, useful for side effects or element processing.

forEachIndexed<T>(arr: [T], procedure: fn(T, Number) -> T) -> Nothing

Similar to forEach, but passes both the element and its current index to the procedure function. This is especially useful when you need to know the position of an element within the array while iterating over it.

while<T>(state: T, condition: fn(T) -> Boolean, procedure: fn(T) -> T) -> Nothing

A recursive, state-based implementation of a while loop. It continuously evaluates the condition function with the current state. As long as the condition returns true, it executes the procedure function to obtain the next_state and recurses. This is a purely functional way to represent while loops.

range(start: Number, end: Number) -> [Number]

Generates and returns an array of sequential numbers starting from start up to and including end. This provides a convenient way to create numeric arrays for counting or iteration.