The SML/NJ Library is a collection of libraries that are distributed with SML/NJ. Due to differences between SML/NJ and MLton, these libraries will not work out-of-the box with MLton.
As of 20151110, MLton includes a port of the SML/NJ Library synchronized with SML/NJ version 110.78.
You can import a sub-library of the SML/NJ Library into an MLB file with:
MLB file Description
Various utility modules, included collections, simple formating, …
A library for managing control flags in an application.
Support for implementing hash-consed data structures.
HTML 3.2 parsing and pretty-printing library.
HTML 4.01 parsing and pretty-printing library.
Networking utilities; supported on both Unix and Windows systems.
Reactive scripting library.
Regular expression library.
Utilities for Unix-based operating systems.
# SMLNJ Library $SMLNJ-LIB $(SML_LIB)/smlnj-lib $smlnj-lib.cm $(SML_LIB)/smlnj-lib/Util $controls-lib.cm $(SML_LIB)/smlnj-lib/Controls $hash-cons-lib.cm $(SML_LIB)/smlnj-lib/HashCons $html-lib.cm $(SML_LIB)/smlnj-lib/HTML $html4-lib.cm $(SML_LIB)/smlnj-lib/HTML4 $inet-lib.cm $(SML_LIB)/smlnj-lib/INet $json-lib.cm $(SML_LIB)/smlnj-lib/JSON $pp-lib.cm $(SML_LIB)/smlnj-lib/PP $reactive-lib.cm $(SML_LIB)/smlnj-lib/Reactive $regexp-lib.cm $(SML_LIB)/smlnj-lib/RegExp $sexp-lib.cm $(SML_LIB)/smlnj-lib/SExp $unix-lib.cm $(SML_LIB)/smlnj-lib/Unix $xml-lib.cm $(SML_LIB)/smlnj-lib/XML
This will automatically convert a $/smlnj-lib.cm import in an input .cm file into a $(SML_LIB)/smlnj-lib/Util/smlnj-lib.mlb import in the output .mlb file.
The following changes were made to the SML/NJ Library, in addition to deriving the .mlb files from the .cm files:
HTML4/pp-init.sml (added): Implements structure PrettyPrint using the SML/NJ PP Library. This implementation is taken from the SML/NJ compiler source, since the SML/NJ HTML4 Library used the structure PrettyPrint provided by the SML/NJ compiler itself.
Util/base64.sml (modified): Rewrote use of Unsafe.CharVector.create and Unsafe.CharVector.update; MLton assumes that vectors are immutable.
Util/bit-array.sml (modified): The computation of the maxLen is given by:
val maxLen = 8*Word8Array.maxLen
This is fine in SML/NJ where Word8Array.maxLen is 16777215, but in MLton, Word8Array.maxLen is equal to valOf(Int.maxInt), so the computation overflows. To accommodate both SML/NJ and MLton, the computation is replaced by
val maxLen = (8*Word8Array.maxLen) handle Overflow => Word8Array.maxLen
Util/graph-scc-fn.sml (modified): Rewrote use of where structure specification.
Util/redblack-map-fn.sml (modified): Rewrote use of where structure specification.
Util/redblack-set-fn.sml (modified): Rewrote use of where structure specification.
Util/time-limit.mlb (added): Exports structure TimeLimit, which is not exported by smlnj-lib.mlb. Since MLton is very conservative in the presence of threads and signals, program performance may be adversely affected by unnecessarily including structure TimeLimit.
Util/time-limit.mlton.sml (added): Implements structure TimeLimit using structure Engine. The SML/NJ implementation of structure TimeLimit uses SML/NJ’s first-class continuations, signals, and interval timer.