GNU Info

(guile.info)Loading

---

Next: Delayed Evaluation Prev: Fly Evaluation Up: Read/Load/Eval

---

Enter node , (file) or (file)node

Loading Scheme Code from File
=============================

 - primitive: primitive-load filename
     Load FILE and evaluate its contents in the top-level environment.
     The load paths are not searched; FILE must either be a full
     pathname or be a pathname relative to the current directory.  If
     the variable `%load-hook' is defined, it should be bound to a
     procedure that will be called before any code is loaded.  See
     documentation for `%load-hook' later in this section.

 - primitive: primitive-load-path filename
     Search %LOAD-PATH for FILE and load it into the top-level
     environment.  If FILE is a relative pathname and is not found in
     the list of search paths, an error is signalled.

 - primitive: %search-load-path filename
     Search %LOAD-PATH for FILE, which must be readable by the current
     user.  If FILE is found in the list of paths to search or is an
     absolute pathname, return its full pathname.  Otherwise, return
     `#f'.  Filenames may have any of the optional extensions in the
     `%load-extensions' list; `%search-load-path' will try each
     extension automatically.

 - Variable: %load-hook
     A procedure to be run whenever `primitive-load' is called.  If this
     procedure is defined, it will be called with the filename argument
     that was passed to `primitive-load'.

          (define %load-hook (lambda (file)
                               (display "Loading ")
                               (display file)
                               (write-line "...."))) => undefined
          (load-from-path "foo.scm")
          -| Loading /usr/local/share/guile/site/foo.scm....


 - primitive: current-load-port
     Return the current-load-port.  The load port is used internally by
     `primitive-load'.

 - Variable: %load-extensions
     A list of default file extensions for files containing Scheme code.
     `%search-load-path' tries each of these extensions when looking for
     a file to load.  By default, `%load-extensions' is bound to the
     list `("" ".scm")'.