File: Comma-Separated-Lists.html

package info (click to toggle)
octave 6.2.0-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 124,192 kB
  • sloc: cpp: 322,665; ansic: 68,088; fortran: 20,980; objc: 8,121; sh: 7,719; yacc: 4,266; lex: 4,123; perl: 1,530; java: 1,366; awk: 1,257; makefile: 424; xml: 147
file content (115 lines) | stat: -rw-r--r-- 5,352 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
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
<!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>Comma Separated Lists (GNU Octave (version 6.2.0))</title>

<meta name="description" content="Comma Separated Lists (GNU Octave (version 6.2.0))">
<meta name="keywords" content="Comma Separated Lists (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="Data-Containers.html" rel="up" title="Data Containers">
<link href="Comma-Separated-Lists-Generated-from-Cell-Arrays.html" rel="next" title="Comma Separated Lists Generated from Cell Arrays">
<link href="Processing-Data-in-Cell-Arrays.html" rel="prev" title="Processing Data in Cell Arrays">
<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="Comma-Separated-Lists"></span><div class="header">
<p>
Previous: <a href="Cell-Arrays.html" accesskey="p" rel="prev">Cell Arrays</a>, Up: <a href="Data-Containers.html" accesskey="u" rel="up">Data Containers</a> &nbsp; [<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="Comma-Separated-Lists-1"></span><h3 class="section">6.4 Comma Separated Lists</h3>
<span id="index-comma-separated-lists"></span>
<span id="index-cs_002dlists"></span>

<p>Comma separated lists <a id="DOCF2" href="#FOOT2"><sup>2</sup></a> are the basic argument type
to all Octave functions - both for input and return arguments.  In the
example
</p>
<div class="example">
<pre class="example">max (<var>a</var>, <var>b</var>)
</pre></div>

<p>&lsquo;<samp><var>a</var>, <var>b</var></samp>&rsquo; is a comma separated list.  Comma separated lists
can appear on both the right and left hand side of an assignment.  For
example
</p>
<div class="example">
<pre class="example">x = [1 0 1 0 0 1 1; 0 0 0 0 0 0 7];
[<var>i</var>, <var>j</var>] = find (<var>x</var>, 2, &quot;last&quot;);
</pre></div>

<p>Here, &lsquo;<samp><var>x</var>, 2, &quot;last&quot;</samp>&rsquo; is a comma separated list constituting
the input arguments of <code>find</code>.  <code>find</code> returns a comma
separated list of output arguments which is assigned element by
element to the comma separated list &lsquo;<samp><var>i</var>, <var>j</var></samp>&rsquo;.
</p>
<p>Another example of where comma separated lists are used is in the
creation of a new array with <code>[]</code> (see <a href="Matrices.html">Matrices</a>) or the
creation of a cell array with <code>{}</code> (see <a href="Basic-Usage-of-Cell-Arrays.html">Basic Usage of Cell Arrays</a>).  In the expressions
</p>
<div class="example">
<pre class="example">a = [1, 2, 3, 4];
c = {4, 5, 6, 7};
</pre></div>

<p>both &lsquo;<samp>1, 2, 3, 4</samp>&rsquo; and &lsquo;<samp>4, 5, 6, 7</samp>&rsquo; are comma separated lists.
</p>
<p>Comma separated lists cannot be directly manipulated by the
user.  However, both structure arrays and cell arrays can be converted
into comma separated lists, and thus used in place of explicitly
written comma separated lists.  This feature is useful in many ways,
as will be shown in the following subsections.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="Comma-Separated-Lists-Generated-from-Cell-Arrays.html" accesskey="1">Comma Separated Lists Generated from Cell Arrays</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Comma-Separated-Lists-Generated-from-Structure-Arrays.html" accesskey="2">Comma Separated Lists Generated from Structure Arrays</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<div class="footnote">
<hr>
<h4 class="footnotes-heading">Footnotes</h4>

<h5><a id="FOOT2" href="#DOCF2">(2)</a></h3>
<p>Comma-separated lists are also sometimes
informally referred to as <em>cs-lists</em>.</p>
</div>
<hr>
<div class="header">
<p>
Previous: <a href="Cell-Arrays.html" accesskey="p" rel="prev">Cell Arrays</a>, Up: <a href="Data-Containers.html" accesskey="u" rel="up">Data Containers</a> &nbsp; [<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>