1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43
|
<html>
<head><title>SET-MEASURE-FUNCTION.html -- ACL2 Version 3.1</title></head>
<body text=#000000 bgcolor="#FFFFFF">
<h2>SET-MEASURE-FUNCTION</h2>set the default measure function symbol
<pre>Major Section: <a href="EVENTS.html">EVENTS</a>
</pre><p>
<pre>
Examples:
(set-measure-function nqthm::count)
</pre>
Note: This is an event! It does not print the usual event summary
but nevertheless changes the ACL2 logical <a href="WORLD.html">world</a> and is so
recorded.
<p>
<pre>
General Form:
(set-measure-function name)
</pre>
where <code>name</code> is a function symbol of one argument. This macro is
equivalent to <code>(table acl2-defaults-table :measure-function 'name)</code>,
and hence is <code><a href="LOCAL.html">local</a></code> to any <a href="BOOKS.html">books</a> and <code><a href="ENCAPSULATE.html">encapsulate</a></code> <a href="EVENTS.html">events</a>
in which it occurs; see <a href="ACL2-DEFAULTS-TABLE.html">acl2-defaults-table</a>. Although this is thus an event
(see <a href="TABLE.html">table</a>), nevertheless no output results from a <code>set-measure-function</code>
event.<p>
This event sets the default measure function to <code>name</code>. Subsequently,
if a recursively defined function is submitted to <code><a href="DEFUN.html">defun</a></code> with no
explicitly given <code>:measure</code> argument, <code><a href="DEFUN.html">defun</a></code> ``guesses'' the measure
<code>(name var)</code>, where <code>name</code> is the then current default measure function
and <code>var</code> is the first formal found to be tested along every branch
and changed in every recursive call.<p>
Note that if <code>(table acl2-defaults-table :measure-function 'name)</code> has its
default value of <code>nil</code>, then the default measure function is
<code><a href="ACL2-COUNT.html">acl2-count</a></code>.
<br><br><br><a href="acl2-doc.html"><img src="llogo.gif"></a> <a href="acl2-doc-index.html"><img src="index.gif"></a>
</body>
</html>
|