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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Function Handles (GNU Octave (version 6.2.0))</title>
<meta name="description" content="Function Handles (GNU Octave (version 6.2.0))">
<meta name="keywords" content="Function Handles (GNU Octave (version 6.2.0))">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html" rel="start" title="Top">
<link href="Concept-Index.html" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Function-Handles-and-Anonymous-Functions.html" rel="up" title="Function Handles and Anonymous Functions">
<link href="Anonymous-Functions.html" rel="next" title="Anonymous Functions">
<link href="Function-Handles-and-Anonymous-Functions.html" rel="prev" title="Function Handles and Anonymous Functions">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
<link rel="stylesheet" type="text/css" href="octave.css">
</head>
<body lang="en">
<span id="Function-Handles"></span><div class="header">
<p>
Next: <a href="Anonymous-Functions.html" accesskey="n" rel="next">Anonymous Functions</a>, Up: <a href="Function-Handles-and-Anonymous-Functions.html" accesskey="u" rel="up">Function Handles and Anonymous Functions</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="Function-Handles-1"></span><h4 class="subsection">11.12.1 Function Handles</h4>
<p>A function handle is a pointer to another function and is defined with
the syntax
</p>
<div class="example">
<pre class="example">@<var>function-name</var>
</pre></div>
<p>For example,
</p>
<div class="example">
<pre class="example">f = @sin;
</pre></div>
<p>creates a function handle called <code>f</code> that refers to the
function <code>sin</code>.
</p>
<p>Function handles are used to call other functions indirectly, or to pass
a function as an argument to another function like <code>quad</code> or
<code>fsolve</code>. For example:
</p>
<div class="example">
<pre class="example">f = @sin;
quad (f, 0, pi)
⇒ 2
</pre></div>
<p>You may use <code>feval</code> to call a function using function handle, or
simply write the name of the function handle followed by an argument
list. If there are no arguments, you must use an empty argument list
‘<samp>()</samp>’. For example:
</p>
<div class="example">
<pre class="example">f = @sin;
feval (f, pi/4)
⇒ 0.70711
f (pi/4)
⇒ 0.70711
</pre></div>
<span id="XREFis_005ffunction_005fhandle"></span><dl>
<dt id="index-is_005ffunction_005fhandle">: <em></em> <strong>is_function_handle</strong> <em>(<var>x</var>)</em></dt>
<dd><p>Return true if <var>x</var> is a function handle.
</p>
<p><strong>See also:</strong> <a href="Built_002din-Data-Types.html#XREFisa">isa</a>, <a href="Data-Types.html#XREFtypeinfo">typeinfo</a>, <a href="Built_002din-Data-Types.html#XREFclass">class</a>, <a href="#XREFfunctions">functions</a>.
</p></dd></dl>
<span id="XREFfunctions"></span><dl>
<dt id="index-functions">: <em><var>s</var> =</em> <strong>functions</strong> <em>(<var>fcn_handle</var>)</em></dt>
<dd><p>Return a structure containing information about the function handle
<var>fcn_handle</var>.
</p>
<p>The structure <var>s</var> always contains these three fields:
</p>
<dl compact="compact">
<dt>function</dt>
<dd><p>The function name. For an anonymous function (no name) this will be the
actual function definition.
</p>
</dd>
<dt>type</dt>
<dd><p>Type of the function.
</p>
<dl compact="compact">
<dt>anonymous</dt>
<dd><p>The function is anonymous.
</p>
</dd>
<dt>private</dt>
<dd><p>The function is private.
</p>
</dd>
<dt>overloaded</dt>
<dd><p>The function overloads an existing function.
</p>
</dd>
<dt>simple</dt>
<dd><p>The function is a built-in or m-file function.
</p>
</dd>
<dt>subfunction</dt>
<dd><p>The function is a subfunction within an m-file.
</p></dd>
</dl>
</dd>
<dt>nested</dt>
<dd><p>The function is nested.
</p>
</dd>
<dt>file</dt>
<dd><p>The m-file that will be called to perform the function. This field is empty
for anonymous and built-in functions.
</p></dd>
</dl>
<p>In addition, some function types may return more information in additional
fields.
</p>
<p><strong>Warning:</strong> <code>functions</code> is provided for debugging purposes only.
Its behavior may change in the future and programs should not depend on any
particular output format.
</p>
<p><strong>See also:</strong> <a href="#XREFfunc2str">func2str</a>, <a href="#XREFstr2func">str2func</a>.
</p></dd></dl>
<span id="XREFfunc2str"></span><dl>
<dt id="index-func2str">: <em></em> <strong>func2str</strong> <em>(<var>fcn_handle</var>)</em></dt>
<dd><p>Return a string containing the name of the function referenced by the
function handle <var>fcn_handle</var>.
</p>
<p><strong>See also:</strong> <a href="#XREFstr2func">str2func</a>, <a href="#XREFfunctions">functions</a>.
</p></dd></dl>
<span id="XREFstr2func"></span><dl>
<dt id="index-str2func">: <em></em> <strong>str2func</strong> <em>(<var>fcn_name</var>)</em></dt>
<dd><p>Return a function handle constructed from the string <var>fcn_name</var>.
</p>
<p>Previous versions of Octave accepted an optional second argument,
<code>"global"</code>, that caused str2func to ignore locally visible
functions. This option is no longer supported.
</p>
<p><strong>See also:</strong> <a href="#XREFfunc2str">func2str</a>, <a href="#XREFfunctions">functions</a>.
</p></dd></dl>
<hr>
<div class="header">
<p>
Next: <a href="Anonymous-Functions.html" accesskey="n" rel="next">Anonymous Functions</a>, Up: <a href="Function-Handles-and-Anonymous-Functions.html" accesskey="u" rel="up">Function Handles and Anonymous Functions</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|
