123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187 |
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
- <html>
- <!-- Created on December 10, 2012 by texi2html 1.82
- texi2html was written by:
- Lionel Cons <[email protected]> (original author)
- Karl Berry <[email protected]>
- Olaf Bachmann <[email protected]>
- and many others.
- Maintained by: Many creative people.
- Send bugs and suggestions to <[email protected]>
- -->
- <head>
- <title>avram - a virtual machine code interpreter: D. External Libraries</title>
- <meta name="description" content="avram - a virtual machine code interpreter: D. External Libraries">
- <meta name="keywords" content="avram - a virtual machine code interpreter: D. External Libraries">
- <meta name="resource-type" content="document">
- <meta name="distribution" content="global">
- <meta name="Generator" content="texi2html 1.82">
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
- <style type="text/css">
- <!--
- a.summary-letter {text-decoration: none}
- blockquote.smallquotation {font-size: smaller}
- pre.display {font-family: serif}
- pre.format {font-family: serif}
- pre.menu-comment {font-family: serif}
- pre.menu-preformatted {font-family: serif}
- pre.smalldisplay {font-family: serif; font-size: smaller}
- pre.smallexample {font-size: smaller}
- pre.smallformat {font-family: serif; font-size: smaller}
- pre.smalllisp {font-size: smaller}
- span.roman {font-family:serif; font-weight:normal;}
- span.sansserif {font-family:sans-serif; font-weight:normal;}
- ul.toc {list-style: none}
- -->
- </style>
- </head>
- <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
- <a name="External-Libraries"></a>
- <table cellpadding="1" cellspacing="1" border="0">
- <tr><td valign="middle" align="left">[<a href="Changes.html#Changes" title="Previous section in reading order"> < </a>]</td>
- <td valign="middle" align="left">[<a href="bes.html#bes" title="Next section in reading order"> > </a>]</td>
- <td valign="middle" align="left"> </td>
- <td valign="middle" align="left">[<a href="Changes.html#Changes" title="Beginning of this chapter or previous chapter"> << </a>]</td>
- <td valign="middle" align="left">[<a href="avram.html#Top" title="Up section"> Up </a>]</td>
- <td valign="middle" align="left">[<a href="Copying.html#Copying" title="Next chapter"> >> </a>]</td>
- <td valign="middle" align="left"> </td>
- <td valign="middle" align="left"> </td>
- <td valign="middle" align="left"> </td>
- <td valign="middle" align="left"> </td>
- <td valign="middle" align="left">[<a href="avram.html#Top" title="Cover (top) of document">Top</a>]</td>
- <td valign="middle" align="left">[<a href="avram_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
- <td valign="middle" align="left">[<a href="Function-Index.html#Function-Index" title="Index">Index</a>]</td>
- <td valign="middle" align="left">[<a href="avram_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
- </tr></table>
- <hr size="1">
- <a name="External-Libraries-1"></a>
- <h1 class="appendix">D. External Libraries</h1>
- <p>Various functions are callable from virtual code applications by way
- of the <code>library</code> combinator as explained in <a href="Library-combinator.html#Library-combinator">Library combinator</a>. An expression (shown in <code>silly</code> syntax) of the form
- <code>library('foo','bar') x</code> applies a function named <code>'bar'</code>
- from a library named <code>'foo'</code> to an argument <code>x</code>.
- </p>
- <p>A brief overview of the libraries and functions can always be had by
- executing
- </p>
- <table><tr><td> </td><td><pre class="example">$ avram --external-libraries
- </pre></td></tr></table>
- <p>The listing displayed by this command may show some that are not
- included here if this version of the documentation is not current or
- your installation has been locally enhanced. It may also lack some
- that are documented here if your installation is not fully equipped.
- </p>
- <p>Although the overview from the command line is adequate for a
- reminder, it is not informative enough to explain how each function
- should be used. The purpose of this section is to provide this
- information in greater detail.
- </p>
- <p>Some general comments are applicable to all libraries.
- </p>
- <p>Each library documented in this section can generate error messages in
- the event of exceptional conditions, that are documented individually.
- In addition to those, it’s also possible for any library function to
- return error messages of
- <a name="index-unrecognized-library"></a>
- <a name="index-unrecognized-function-name"></a>
- </p>
- <table><tr><td> </td><td><pre class="example"><'unrecognized library'>
- <'unrecognized <var>xxxx</var> function name'>
- </pre></td></tr></table>
- <p>where <var>xxxx</var> is the name of a library. These indicate either that
- the library name is invalid, or the library name is valid but the
- function name is invalid, or that they’re both valid but the library
- wasn’t detected on the host when <code>avram</code> was compiled. A virtual
- code application can always avoid these errors by testing for the
- availability of a function using the <code>have</code> combinator (<a href="Have-combinator.html#Have-combinator">Have combinator</a>).
- </p>
- <p>In addition, any library function that operates on numerical values or
- lists thereof can return these messages in cases of invalid input.
- <a name="index-missing-value-1"></a>
- <a name="index-invalid-value-1"></a>
- <a name="index-bad-vector-specification"></a>
- <a name="index-bad-matrix-specification"></a>
- </p>
- <table><tr><td> </td><td><pre class="example"><'missing value'>
- <'invalid value'>
- <'bad vector specification'>
- <'bad matrix specification'>
- </pre></td></tr></table>
- <p>These messages indicate that an input parameter that was required to
- be a valid representation of a floating point number, a vector,
- or a matrix was something other than that (<a href="Type-Conversions.html#Type-Conversions">Type Conversions</a>).
- The last could also occur if a parameter that is required to be
- a square matrix has unequal numbers of rows and columns.
- </p>
- <table class="menu" border="0" cellspacing="0">
- <tr><td align="left" valign="top"><a href="bes.html#bes">D.1 <code>bes</code></a></td><td> </td><td align="left" valign="top"> Bessel functions
- </td></tr>
- <tr><td align="left" valign="top"><a href="complex.html#complex">D.2 <code>complex</code></a></td><td> </td><td align="left" valign="top"> native complex arithmetic
- </td></tr>
- <tr><td align="left" valign="top"><a href="fftw.html#fftw">D.3 <code>fftw</code></a></td><td> </td><td align="left" valign="top"> fast Fourier transforms
- </td></tr>
- <tr><td align="left" valign="top"><a href="glpk.html#glpk">D.4 <code>glpk</code></a></td><td> </td><td align="left" valign="top"> simplex linear programming
- </td></tr>
- <tr><td align="left" valign="top"><a href="gsldif.html#gsldif">D.5 <code>gsldif</code></a></td><td> </td><td align="left" valign="top"> numerical differentiation
- </td></tr>
- <tr><td align="left" valign="top"><a href="gslevu.html#gslevu">D.6 <code>gslevu</code></a></td><td> </td><td align="left" valign="top"> series acceleration
- </td></tr>
- <tr><td align="left" valign="top"><a href="gslint.html#gslint">D.7 <code>gslint</code></a></td><td> </td><td align="left" valign="top"> numerical integration
- </td></tr>
- <tr><td align="left" valign="top"><a href="harminv.html#harminv">D.8 <code>harminv</code></a></td><td> </td><td align="left" valign="top"> harmonic inversion
- </td></tr>
- <tr><td align="left" valign="top"><a href="kinsol.html#kinsol">D.9 <code>kinsol</code></a></td><td> </td><td align="left" valign="top"> constrained non-linear optimization
- </td></tr>
- <tr><td align="left" valign="top"><a href="lapack.html#lapack">D.10 <code>lapack</code></a></td><td> </td><td align="left" valign="top"> linear algebra
- </td></tr>
- <tr><td align="left" valign="top"><a href="math.html#math">D.11 <code>math</code></a></td><td> </td><td align="left" valign="top"> native floating point arithmetic
- </td></tr>
- <tr><td align="left" valign="top"><a href="mtwist.html#mtwist">D.12 <code>mtwist</code></a></td><td> </td><td align="left" valign="top"> random number generation
- </td></tr>
- <tr><td align="left" valign="top"><a href="minpack.html#minpack">D.13 <code>minpack</code></a></td><td> </td><td align="left" valign="top"> non-linear optimization
- </td></tr>
- <tr><td align="left" valign="top"><a href="mpfr.html#mpfr">D.14 <code>mpfr</code></a></td><td> </td><td align="left" valign="top"> arbitrary precision arithmetic
- </td></tr>
- <tr><td align="left" valign="top"><a href="lpsolve.html#lpsolve">D.15 <code>lpsolve</code></a></td><td> </td><td align="left" valign="top"> mixed integer programming
- </td></tr>
- <tr><td align="left" valign="top"><a href="rmath.html#rmath">D.16 <code>rmath</code></a></td><td> </td><td align="left" valign="top"> statistical and special functions
- </td></tr>
- <tr><td align="left" valign="top"><a href="umf.html#umf">D.17 <code>umf</code></a></td><td> </td><td align="left" valign="top"> sparse matrices
- </td></tr>
- </table>
- <hr size="1">
- <table cellpadding="1" cellspacing="1" border="0">
- <tr><td valign="middle" align="left">[<a href="Changes.html#Changes" title="Previous section in reading order"> < </a>]</td>
- <td valign="middle" align="left">[<a href="bes.html#bes" title="Next section in reading order"> > </a>]</td>
- <td valign="middle" align="left"> </td>
- <td valign="middle" align="left">[<a href="Changes.html#Changes" title="Beginning of this chapter or previous chapter"> << </a>]</td>
- <td valign="middle" align="left">[<a href="avram.html#Top" title="Up section"> Up </a>]</td>
- <td valign="middle" align="left">[<a href="Copying.html#Copying" title="Next chapter"> >> </a>]</td>
- <td valign="middle" align="left"> </td>
- <td valign="middle" align="left"> </td>
- <td valign="middle" align="left"> </td>
- <td valign="middle" align="left"> </td>
- <td valign="middle" align="left">[<a href="avram.html#Top" title="Cover (top) of document">Top</a>]</td>
- <td valign="middle" align="left">[<a href="avram_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
- <td valign="middle" align="left">[<a href="Function-Index.html#Function-Index" title="Index">Index</a>]</td>
- <td valign="middle" align="left">[<a href="avram_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
- </tr></table>
- <p>
- <font size="-1">
- This document was generated on <i>December 10, 2012</i> using <a href="http://www.nongnu.org/texi2html/"><i>texi2html 1.82</i></a>.
- </font>
- <br>
- </p>
- </body>
- </html>
|