File: MV-NTH.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 (28 lines) | stat: -rw-r--r-- 1,181 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
26
27
28
<html>
<head><title>MV-NTH.html  --  ACL2 Version 3.1</title></head>
<body text=#000000 bgcolor="#FFFFFF">
<h2>MV-NTH</h2>the mv-nth element (zero-based) of a list
<pre>Major Section:  <a href="PROGRAMMING.html">PROGRAMMING</a>
</pre><p>

<code>(Mv-nth n l)</code> is the <code>n</code>th element of <code>l</code>, zero-based.  If <code>n</code> is
greater than or equal to the length of <code>l</code>, then <code>mv-nth</code> returns
<code>nil</code>.
<p>
<code>(Mv-nth n l)</code> has a <a href="GUARD.html">guard</a> that <code>n</code> is a non-negative integer and
<code>l</code> is a <code><a href="TRUE-LISTP.html">true-listp</a></code>.<p>

<code>Mv-nth</code> is equivalent to the Common Lisp function <code><a href="NTH.html">nth</a></code>, but is used by
ACL2 to access the nth value returned by a multiply valued expression.  For
an example of the use of <code>mv-nth</code>, try

<pre>
ACL2 !&gt;:trans1 (mv-let (erp val state)
                       (read-object ch state)
                       (value (list erp val)))
</pre>


<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>