Nominal.Unsafe

This module provides three primitive functions that use unsafePerformIO. These functions are only safe if used correctly. How to use each function correctly is specified in its documentation.

This module exposes implementation details of the Nominal library, and should not normally be imported. Users of the library should only import the top-level module Nominal.

Documentation

global_used :: IORef (Set String)

A global variable holding a set of strings already used for free names.

The use of unsafePerformIO in this function is safe, because it is only called once and serves to create a unique global reference cell.

global_new_io :: NameGen -> IO String

Create a globally new concrete name based on the given name suggestion. This ensures that fresh names have distinct names when they are not bound.

global_new :: NameGen -> String

Create a globally new concrete name based on the given name suggestion.

The use of unsafePerformIO in this function is safe, provided that the user only uses API functions and respects Pitts's freshness condition.

with_unique :: (Unique -> a) -> a

Perform a subcomputation in the presence of a globally unique value. This is similar to newUnique, but uses a continuation monad instead of the IO monad. To ensure referential transparency, the unique value must not escape the function body.

The use of unsafePerformIO in this function is safe, provided that the user only uses API functions and respects Pitts's freshness condition.

unsafe_with :: IO a -> (a -> b) -> b

Unsafely embed the IO monad in a continuation monad.

The use of unsafePerformIO in this function is safe, provided that the user only uses API functions and respects Pitts's freshness condition.