This repository has been archived on 2023-08-20. You can view files and clone it, but cannot push or open issues or pull requests.
yap-6.3/Logtalk/manuals/refman/builtins/logtalk_load1.html
pmoura 755c60a7ca Logtalk 2.22.5 files.
git-svn-id: https://yap.svn.sf.net/svnroot/yap/trunk@1244 b08c6af1-5177-4d33-ba66-4b1c6b8b522a
2005-02-10 00:02:06 +00:00

86 lines
3.3 KiB
HTML

<?xml version="1.0" encoding="iso-8859-1"?>
<?xml-stylesheet type="text/css" href="../../styles.css" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
<title>Logtalk built-in predicate: logtalk_load/1</title>
<link rel="stylesheet" href="../../styles.css" type="text/css" />
</head>
<body>
<div class="navtop">
<a href="../../index.html">contents</a> &gt; <a href="../index.html">reference manual</a> &gt; <a href="../index.html#builtins">built-in predicates</a>
</div>
<h2><code>logtalk_load/1</code></h2>
<h4>Description</h4>
<blockquote>
<pre>logtalk_load(Entity)
logtalk_load(Entities)</pre>
<p>
Compiles to disk and then loads to memory an entity, a list of entities (objects, protocols or categories), or a source metafile using the default compiler flags specified in the Logtalk configuration file. The Logtalk file name extension (by default, <code>.lgt</code> for entity source files and <code>.mlgt</code> for source metafiles) should be omitted. Note that the argument is a list of entity/file names, not file paths. In other words, the files must exist in the current working directory.
</p>
<p>
Note that only the errors related to problems in the predicate argument are listed below. Other exceptions may be thrown by the compiler if any of the loaded entities contains syntax errors.
</p>
</blockquote>
<h4>Template and modes</h4>
<blockquote>
<pre>logtalk_load(@entity_file_name)
logtalk_load(@entity_file_name_list)</pre>
</blockquote>
<h4>Errors</h4>
<blockquote>
<dl>
<dt>Entity is a variable:</dt>
<dd><code>instantiation_error</code></dd>
<dt>Entities is a variable or a list with an element which is a variable:</dt>
<dd><code>instantiation_error</code></dd>
<dt>Entity, or an element Entity of the Entities list, is neither a variable nor an entity file name nor a library entity file name:</dt>
<dd><code>type_error(entity_file_name, Entity)</code></dd>
<dt>Entity, or an element Entity of the Entities list, is a compound term but not a library entity file name:</dt>
<dd><code>type_error(library_entity_file_name, Entity)</code></dd>
<dt>Entity or an element Entity of the Entities list does not exist in the current working directory or in the specified library directory:</dt>
<dd><code>existence_error(entity, Entity)</code></dd>
<dt>Entity library does not exist:</dt>
<dd><code>existence_error(library, Library)</code></dd>
</dl>
</blockquote>
<h4>Examples</h4>
<blockquote>
<pre>| ?- logtalk_load(set).
| ?- logtalk_load(types(tree)).
| ?- logtalk_load([listp, list]).</pre>
</blockquote>
<div class="navbottom">
<a href="logtalk_compile1.html">previous</a> | <a href="../../glossary.html">glossary</a> | <a href="logtalk_load2.html">next</a>
</div>
<div class="copyright">
Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://www.logtalk.org">Logtalk.org</a>
</div>
<div class="footer">
<p><span class="bleft"><a href="http://validator.w3.org/check/referer">XHTML</a> + <a href="http://jigsaw.w3.org/css-validator/check/referer">CSS</a></span><span class="bright">Last updated on: February 6, 2005</span></p>
</div>
</body>
</html>