File: MV.html

package info (click to toggle)
acl2 3.1-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 36,712 kB
  • ctags: 38,396
  • sloc: lisp: 464,023; makefile: 5,470; sh: 86; csh: 47; cpp: 25; ansic: 22
file content (25 lines) | stat: -rw-r--r-- 1,186 bytes parent folder | download
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
<html>
<head><title>MV.html  --  ACL2 Version 3.1</title></head>
<body text=#000000 bgcolor="#FFFFFF">
<h2>MV</h2>returning a multiple value
<pre>Major Section:  <a href="PROGRAMMING.html">PROGRAMMING</a>
</pre><p>

<code>Mv</code> is the mechanism provided by ACL2 for returning two or more
values.  Logically, <code>(mv x1 x2 ... xn)</code> is the same as
<code>(list x1 x2 ... xn)</code>, a list of the indicated values.  However,
ACL2 avoids the cost of building this list structure, with the cost
that <code>mv</code> may only be used in a certain style in definitions:  if a
function ever returns using <code>mv</code> (either directly, or by calling
another function that returns a multiple value), then this function
must always return the same number of values.<p>

For more explanation of the multiple value mechanism,
see <a href="MV-LET.html">mv-let</a>.
<p>
ACL2 does not support the Common Lisp construct <code>values</code>, whose
logical meaning seems difficult to characterize.  <code>Mv</code> is the ACL2
analogue of that construct.
<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>