Standard Library
Synopsis
The Rascal Standard Library contains basic utility functions in relation to all built-in data structures, reusable tools (intermediate formats) for analysis and visualization of software languages, and language support for a number of common exchange formats and programming languages.
Description
The basic Prelude modules that contain utility functions for daily usage are right here in the
root of the library. To include them all in one go, use the Prelude module:
rascal>import Prelude;
ok
rascal>println("Hello Rascal!");
Hello Rascal!
ok
The IO module is otherwise most commonly used, because it contains Println.
The standard library has its own location scheme std:/// which can be used to explore
its folder structure on the REPL. Note that source locations have auto-complete for the path component.
rascal>|std:///|.ls
list[loc]: [
|std:///Boolean.rsc|,
|std:///Content.rsc|,
|std:///DateTime.rsc|,
|std:///Exception.rsc|,
|std:///Grammar.rsc|,
|std:///IO.rsc|,
|std:///List.rsc|,
|std:///ListRelation.rsc|,
|std:///Location.rsc|,
|std:///Map.rsc|,
|std:///Message.rsc|,
|std:///Node.rsc|,
|std:///ParseTree.rsc|,
|std:///Prelude$1.class|,
|std:///Prelude$2.class|,
|std:///Prelude$3.class|,
|std:///Prelude$4.class|,
|std:///Prelude$Backtrack.class|,
|std:///Prelude$ByteBufferBackedInputStream.class|,
|std:///Prelude$Distance.class|,
|std:///Prelude$Less.class|,
|std:///Prelude$NodeComparator.class|,
|std:///Prelude$ReleasableCallback.class|,
|std:///Prelude$Sorting.class|,
|std:///Prelude.class|,
|std:///Prelude.rsc|,
|std:///Relation.rsc|,
|std:///Set.rsc|,
|std:///String.rsc|,
|std:///Type.class|,
|std:///Type.rsc|,
|std:///ValueIO.rsc|,
|std:///analysis|,
|std:///index.md|,
|std:///lang|,
|std:///resource|,
|std:///util|,
|std:///vis|
]
These are the entry points to the entire library:
- Boolean
- Content
- Date Time
- Exception
- Grammar
- IO
- List
- List Relation
- Location
- Map
- Message
- Node
- Parse Tree
- Prelude
- Relation
- Set
- String
- Type
- Value IO
- Analysis
- Lang
- Resource
- Util
- Vis
Benefits
- The standard library comes with "batteries included", a number of reusable data-types and data-structures for building code analysis and manipulation tools. See for example Core.
- Utility functions are sorted per data-type. So if you need something that operates on lists then look in the List module of the library. For sets look in Set, etc.
- To process CSV, XML, JSON, YAML you will find utilities here, even support to access SQL databases via JDBC.