• Places
    • Home
    • Graphs
    • Prefixes
  • Admin
    • Users
    • Settings
    • Plugins
    • Statistics
  • CPACK
    • Home
    • List packs
    • Submit pack
  • Repository
    • Load local file
    • Load from HTTP
    • Load from library
    • Remove triples
    • Clear repository
  • Query
    • YASGUI SPARQL Editor
    • Simple Form
    • SWISH Prolog shell
  • Help
    • Documentation
    • Tutorial
    • Roadmap
    • HTTP Services
  • Login

/usr/lib/swipl/library/modules.pl
All Application Manual Name SummaryHelp

  • swipl
    • library
      • error.pl
      • debug.pl
      • apply.pl -- Apply predicates on a list
      • lists.pl -- List Manipulation
      • broadcast.pl -- Event service
      • shlib.pl -- Utility library for loading foreign objects (DLLs, shared objects)
      • option.pl -- Option list processing
      • thread_pool.pl -- Resource bounded thread management
      • gensym.pl -- Generate unique symbols
      • settings.pl
      • arithmetic.pl -- Extensible arithmetic
      • main.pl -- Provide entry point for scripts
      • readutil.pl
      • operators.pl -- Manage operators
      • pairs.pl -- Operations on key-value lists
      • prolog_source.pl -- Examine Prolog source-files
      • quasi_quotations.pl
      • url.pl -- Analysing and constructing URL
      • www_browser.pl
      • prolog_colour.pl -- Prolog syntax colouring support.
      • record.pl -- Access compound arguments by name
      • prolog_xref.pl -- Prolog cross-referencer data collection
      • occurs.pl -- Finding and counting sub-terms
      • ordsets.pl -- Ordered set manipulation
      • assoc.pl -- Binary associations
      • ugraphs.pl -- Graph manipulation library
      • solution_sequences.pl -- Modify solution sequences
      • atom.pl -- Operations on atoms
      • prolog_pack.pl
      • git.pl -- Run GIT commands
      • ctypes.pl -- Character code classification
      • utf8.pl -- UTF-8 encoding/decoding on lists of character codes.
      • base64.pl -- Base64 encoding and decoding
      • persistency.pl -- Provide persistent dynamic predicates
      • pure_input.pl -- Pure Input from files and streams
      • nb_set.pl -- Non-backtrackable sets
      • aggregate.pl -- Aggregation operators on backtrackable predicates
      • csv.pl -- Process CSV (Comma-Separated Values) data
      • iostream.pl -- Utilities to deal with streams
      • dialect.pl -- Support multiple Prolog dialects
      • apply_macros.pl -- Goal expansion rules to avoid meta-calling
      • yall.pl -- Lambda expressions
      • prolog_code.pl -- Utilities for reasoning about code
      • dif.pl -- The dif/2 constraint
      • thread.pl -- High level thread primitives
      • predicate_options.pl -- Access and analyse predicate options
      • rbtrees.pl
      • nb_rbtrees.pl -- Non-backtrackable operations on red black trees
      • sandbox.pl
      • prolog_format.pl -- Analyse format specifications
      • random.pl -- Random numbers
      • pprint.pl -- Pretty Print Prolog terms
      • modules.pl -- Module utility predicates
        • in_temporary_module/3
        • current_temporary_module/1
      • lazy_lists.pl -- Lazy list handling
      • edinburgh.pl -- Some traditional Edinburgh predicates
      • prolog_clause.pl
      • prolog_breakpoints.pl -- Manage Prolog break-points
      • dicts.pl -- Dict utilities
      • help.pl -- Text based manual
      • tables.pl -- XSB interface to tables
      • tableutil.pl -- Table inspection and statistics utilities
      • listing.pl -- List programs and pretty print clauses
      • prolog_profile.pl -- Execution profiler
      • date.pl -- Process dates and times
      • backcomp.pl -- Backward compatibility
      • edit.pl
      • make.pl -- Reload modified source files
      • threadutil.pl -- Interactive thread utilities
      • shell.pl -- Elementary shell commands
      • optparse.pl -- command line parsing
      • prolog_codewalk.pl
      • check.pl
      • heaps.pl -- heaps/priority queues
      • terms.pl
      • quintus.pl
      • strings.pl -- String utilities
      • prolog_stack.pl -- Examine the Prolog stack
      • wfs.pl
      • statistics.pl -- Get information about resource usage
      • charsio.pl -- I/O on Lists of Character Codes
      • oset.pl -- Ordered set manipulation
      • increval.pl
      • coinduction.pl -- Co-Logic Programming
      • varnumbers.pl -- Utilities for numbered terms
      • ansi_term.pl -- Print decorated text to ANSI consoles
      • explain.pl
      • prolog_coverage.pl -- Coverage analysis tool
      • sort.pl
      • fastrw.pl
      • portray_text.pl
      • intercept.pl -- Intercept and signal interface
      • prolog_versions.pl -- Demand specific (Prolog) versions
      • codesio.pl -- I/O on Lists of Character Codes
      • prolog_wrap.pl
      • prolog_debug.pl -- User level debugging tools
      • prolog_metainference.pl -- Infer meta-predicate properties
      • base32.pl -- Base32 encoding and decoding
      • when.pl -- Conditional coroutining
      • prolog_autoload.pl -- Autoload all dependencies
      • system.pl -- System utilities
      • prolog_config.pl
      • prolog_trace.pl
      • rwlocks.pl
      • zip.pl -- Access resource ZIP archives
      • streams.pl -- Manage Prolog streams
      • tty.pl -- Terminal operations
      • prolog_history.pl -- Per-directory persistent commandline history
      • writef.pl -- Old-style formatted write
      • prolog_jiti.pl -- Just In Time Indexing (JITI) utilities
      • prolog_qlfmake.pl -- Compile the library to QLF format
      • hashtable.pl -- Hash tables
      • exceptions.pl -- Exception classification
      • files.pl
      • macros.pl
      • qsave.pl
 in_temporary_module(?Module, :Setup, :Goal)
Run Goal on temporary loaded sources and discard the module and loaded predicates after completion. This predicate performs the following steps:
  1. If Module is unbound, create a unique identifier for it.
  2. Turn Module into a temporary module using set_module/1. Note that this requires the module to be non-existent or empty. If Module is specified, it should typically be set to a unique value as obtained from e.g. uuid/1.
  3. Run Setup in the context of Module.
  4. If setup succeeded possible choice points are discarded and Goal is started.

The logical result of this predicate is the same as `(Setup@Module -> Goal@Module)`, i.e., both Setup and Goal are resolved relative to the current module, but executed in the context of Module. If Goal must be called in Module, use call(Goal).

The module and all its predicates are destroyed after Goal terminates, as defined by setup_call_cleanup/3.

Discussion This predicate is intended to load programs in an isolated environment and reclaim all resources. This unfortunately is incomplete:

  • Running the code may leave side effects such as creating records, flags, changing Prolog flags, etc. The system has no provisions to track this.
  • So called functors (name/arity pairs) are not yet subject to garbage collection. Functors are both used to define predicates and to create compound terms.
See also
- library(sandbox) determines whether unknown goals are safe to call.
- load_files/2 offers the option sandboxed(true) to load code from unknown sources safely.
ClioPatria (version V3.1.1-59-g7b9a7a3)