Libraries.md

Working with libraries and modules

Below is a list of 'core' modules that comes included with the Carp compiler. Modules marked with the symbol '⦁' are imported by default, other modules must be imported by loading their file. For example, to get access to the Bench module, do the following:

(load "Bench.carp")

Using the functions in the Bench module still requires pre-pending them with the module name, i.e. (Bench.bench fib). To avoid that, also do (use Bench).

To see what functions a certain module contains, use the info command:

(info "Bench")

External librares can be loaded by using their relative or absolute location in your file system as the path. To make a library publically available in a more general way you can add it to your Carp project's search path:s (found by running :p in the repl). For instance, here's how you would add the NCurses library so that it can be loaded with just (load "NCurses.carp").

(Project.config "search-path" "~/Projects/carp-ncurses")

This line of configuration can be put into a ~/.carp/profile.carp file to make it apply in all your projects.

Core Modules

Basics

• Macros ⦁
• Interfaces ⦁
• Dynamic ⦁ (only available in the repl and at compile time)

Numerics

• Int ⦁
• SafeInt
• Long ⦁
• Bool ⦁
• Float ⦁
• Double ⦁
• Vector
• Geometry
• Statistics

Text

• String ⦁
• Char ⦁
• Format ⦁
• Pattern ⦁

Collections

• Array ⦁

System

• IO ⦁
• System ⦁

Development

• Debug ⦁
• Test
• Bench

Graphics, sound and interaction

• SDL
• SDL Image
• SDL TTF
• SDL Mixer
• GLFW
• OpenGL

External Libraries

• Stdint (A wrapper around the types defined in stdint.h)
• Socket (A wrapper around C sockets)
• Physics (A port of phys.js)
• NCurses (https://www.gnu.org/software/ncurses/)
• Anima (A simple drawing and animation framework)
• Curl (Simple bindings to the Curl library)