~ubuntu-branches/debian/sid/octave3.0/sid

« back to all changes in this revision

Viewing changes to doc/interpreter/HTML/Function-Handles.html

  • Committer: Bazaar Package Importer
  • Author(s): Rafael Laboissiere
  • Date: 2007-12-23 16:04:15 UTC
  • Revision ID: james.westby@ubuntu.com-20071223160415-n4gk468dihy22e9v
Tags: upstream-3.0.0
ImportĀ upstreamĀ versionĀ 3.0.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<html lang="en">
 
2
<head>
 
3
<title>Function Handles - Untitled</title>
 
4
<meta http-equiv="Content-Type" content="text/html">
 
5
<meta name="description" content="Untitled">
 
6
<meta name="generator" content="makeinfo 4.11">
 
7
<link title="Top" rel="start" href="index.html#Top">
 
8
<link rel="up" href="Function-Handles-Inline-Functions-and-Anonymous-Functions.html#Function-Handles-Inline-Functions-and-Anonymous-Functions" title="Function Handles Inline Functions and Anonymous Functions">
 
9
<link rel="next" href="Anonymous-Functions.html#Anonymous-Functions" title="Anonymous Functions">
 
10
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
 
11
<meta http-equiv="Content-Style-Type" content="text/css">
 
12
<style type="text/css"><!--
 
13
  pre.display { font-family:inherit }
 
14
  pre.format  { font-family:inherit }
 
15
  pre.smalldisplay { font-family:inherit; font-size:smaller }
 
16
  pre.smallformat  { font-family:inherit; font-size:smaller }
 
17
  pre.smallexample { font-size:smaller }
 
18
  pre.smalllisp    { font-size:smaller }
 
19
  span.sc    { font-variant:small-caps }
 
20
  span.roman { font-family:serif; font-weight:normal; } 
 
21
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
 
22
--></style>
 
23
</head>
 
24
<body>
 
25
<div class="node">
 
26
<p>
 
27
<a name="Function-Handles"></a>
 
28
Next:&nbsp;<a rel="next" accesskey="n" href="Anonymous-Functions.html#Anonymous-Functions">Anonymous Functions</a>,
 
29
Up:&nbsp;<a rel="up" accesskey="u" href="Function-Handles-Inline-Functions-and-Anonymous-Functions.html#Function-Handles-Inline-Functions-and-Anonymous-Functions">Function Handles Inline Functions and Anonymous Functions</a>
 
30
<hr>
 
31
</div>
 
32
 
 
33
<h4 class="subsection">11.9.1 Function Handles</h4>
 
34
 
 
35
<p>A function handle is a pointer to another function and is defined with
 
36
the syntax
 
37
 
 
38
<pre class="example">     @<var>function-name</var>
 
39
</pre>
 
40
   <p class="noindent">For example
 
41
 
 
42
<pre class="example">     f = @sin;
 
43
</pre>
 
44
   <p class="noindent">Creates a function handle called <code>f</code> that refers to the
 
45
function <code>sin</code>.
 
46
 
 
47
   <p>Function handles are used to call other functions indirectly, or to pass
 
48
a function as an argument to another function like <code>quad</code> or
 
49
<code>fsolve</code>.  For example
 
50
 
 
51
<pre class="example">     f = @sin;
 
52
     quad (f, 0, pi)
 
53
          2
 
54
</pre>
 
55
   <p>You may use <code>feval</code> to call a function using function handle, or
 
56
simply write the name of the function handle followed by an argument
 
57
list.  If there are no arguments, you must use an empty argument list
 
58
&lsquo;<samp><span class="samp">()</span></samp>&rsquo;.  For example
 
59
 
 
60
<pre class="example">     f = @sin;
 
61
     feval (f, pi/4)
 
62
          0.70711
 
63
     f (pi/4)
 
64
          0.70711
 
65
</pre>
 
66
   <p><a name="doc_002dfunctions"></a>
 
67
 
 
68
<div class="defun">
 
69
&mdash; Built-in Function:  <b>functions</b> (<var>fcn_handle</var>)<var><a name="index-functions-609"></a></var><br>
 
70
<blockquote><p>Return a struct containing information about the function handle
 
71
<var>fcn_handle</var>. 
 
72
</p></blockquote></div>
 
73
 
 
74
   <p><a name="doc_002dfunc2str"></a>
 
75
 
 
76
<div class="defun">
 
77
&mdash; Built-in Function:  <b>func2str</b> (<var>fcn_handle</var>)<var><a name="index-func2str-610"></a></var><br>
 
78
<blockquote><p>Return a string containing the name of the function referenced by
 
79
the function handle <var>fcn_handle</var>. 
 
80
</p></blockquote></div>
 
81
 
 
82
   <p><a name="doc_002dstr2func"></a>
 
83
 
 
84
<div class="defun">
 
85
&mdash; Built-in Function:  <b>str2func</b> (<var>fcn_name</var>)<var><a name="index-str2func-611"></a></var><br>
 
86
<blockquote><p>Return a function handle constructed from the string <var>fcn_name</var>. 
 
87
</p></blockquote></div>
 
88
 
 
89
   </body></html>
 
90