-
Notifications
You must be signed in to change notification settings - Fork 57
/
args.html
151 lines (127 loc) · 3.74 KB
/
args.html
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
<html>
<head>
<title>
ARGS - Command Line Argument Retrieval
</title>
</head>
<body bgcolor="#EEEEEE" link="#CC0000" alink="#FF3300" vlink="#000055">
<h1 align = "center">
ARGS <br> Command Line Argument Retrieval
</h1>
<hr>
<p>
<b>ARGS</b>
is a MATLAB program which
demonstrates command line argument retrieval.
</p>
<p>
In particular, <b>ARGS</b> is a demonstration of the NARGIN function,
which counts command line arguments and the
VARARGIN function, which allows the user to specify that a routine
has a variable number of input arguments.
</p>
<p>
If a MATLAB function takes input arguments, such as
<pre>
function value = summer ( alpha, beta )
</pre>
then there are two ways of supplying some or all the argument
values when invoking the function.
</p>
<p>
We can call with commandline arguments:
<pre>
value = summer
or
value = summer 2
or
value = summer 2 4
</pre>
or with functional arguments:
<pre>
value = summer ( )
or
value = summer ( 2 )
or
value = summer ( 2, 4 )
</pre>
as long as the arguments are processed correctly.
</p>
<p>
In the commandline form, the arguments
will be given to the function as character strings, which must
be re-interpreted as numbers. A convenient way to allow the user
to use either way of invoking the function requires that the
function include a check as to the type of value it has
been given. For example, to handle ALPHA, we might write
<pre>
if ( nargin < 1 )
alpha = input ( 'Enter value of alpha: ' );
elseif ( ischar ( alpha ) )
alpha = str2num ( alpha );
end
</pre>
</p>
<h3 align = "center">
Licensing:
</h3>
<p>
The computer code and data files made available on this web page
are distributed under
<a href = "../../txt/gnu_lgpl.txt">the GNU LGPL license.</a>
</p>
<h3 align = "center">
Languages:
</h3>
<p>
<b>ARGS</b> is available in
<a href = "../../c_src/args/args.html">a C version</a> and
<a href = "../../cpp_src/args/args.html">a C++ version</a> and
<a href = "../../f77_src/args/args.html">a FORTRAN77 version</a> and
<a href = "../../f_src/args/args.html">a FORTRAN90 version</a> and
<a href = "../../java_src/args/args.html">a JAVA version</a> and
<a href = "../../m_src/args/args.html">a MATLAB version</a>.
</p>
<h3 align = "center">
Source Code:
</h3>
<p>
<ul>
<li>
<a href = "args.m">args.m</a>, the source code;
</li>
<li>
<a href = "summer.m">summer.m</a>, a function which
will compute the sum of its two arguments. The function
can be invoked using the commandline or functional form;
some or all of the arguments may be omitted, in which case
the function will request them.
</li>
<li>
<a href = "timestamp.m">timestamp.m</a>,
prints the current YMDHMS date as a timestamp;
</li>
</ul>
</p>
<h3 align = "center">
Examples and Tests:
</h3>
<p>
<ul>
<li>
<a href = "args_output.txt">args_output.txt</a>,
the output of the command <b>args ( 'Joe', 'Gorilla', 'Shazam' )</b>;
</li>
</ul>
</p>
<p>
You can go up one level to <a href = "../m_src.html">
the MATLAB source codes</a>.
</p>
<hr>
<i>
Last revised on 21 April 2013.
</i>
<!-- John Burkardt -->
</body>
</html>