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/methods/retract1.html

84 lines
2.9 KiB
HTML
Raw Normal View History

<?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 method: retract/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#methods">built-in methods</a>
</div>
<h2><code>retract/1</code></h2>
<h4>Description</h4>
<blockquote>
<pre>retract(Clause)
retract((Head:-Body))</pre>
<p>
Retracts a dynamic clause from an object.
</p>
</blockquote>
<h4>Template and modes</h4>
<blockquote>
<pre>retract(+clause)</pre>
</blockquote>
<h4>Errors</h4>
<blockquote>
<dl>
<dt>Head is a variable:</dt>
<dd><code>instantiation_error</code></dd>
<dt>Head is neither a variable nor a callable term:</dt>
<dd><code>type_error(callable, Head)</code></dd>
<dt>The predicate indicator of Head is that of a private predicate:</dt>
<dd><code>permission_error(modify, private_predicate, Head)</code></dd>
<dt>The predicate indicator of Head is that of a protected predicate:</dt>
<dd><code>permission_error(modify, protected_predicate, Head)</code></dd>
<dt>The predicate indicator of Head is that of a static predicate:</dt>
<dd><code>permission_error(modify, static_predicate, Head)</code></dd>
<dt>The predicate indicator of Head is not declared:</dt>
<dd><code>existence_error(predicate_declaration, Head)</code></dd>
</dl>
</blockquote>
<h4>Examples</h4>
<blockquote>
<dl>
<dt>To retract a matching clause of any dynamic predicate in <a class="glossary" title="Go to glossary definition" href="../../glossary.html#this">this</a>:</dt>
<dd><code>retract(Clause)</code></dd>
<dt>To retract a matching clause of a public or protected dynamic predicate in <a class="glossary" title="Go to glossary definition" href="../../glossary.html#self">self</a>:</dt>
<dd><code>::retract(Clause)</code></dd>
<dt>To retract a matching clause of a public dynamic predicate in an object:</dt>
<dd><code>Object::retract(Clause)</code></dd>
</dl>
</blockquote>
<div class="navbottom">
<a href="clause2.html">previous</a> | <a href="../../glossary.html">glossary</a> | <a href="retractall1.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: December 23, 2003</span></p>
</div>
</body>
</html>