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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Octave: Basic Usage of Cell Arrays</title>
<meta name="description" content="GNU Octave: Basic Usage of Cell Arrays">
<meta name="keywords" content="GNU Octave: Basic Usage of Cell Arrays">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Cell-Arrays.html#Cell-Arrays" rel="up" title="Cell Arrays">
<link href="Creating-Cell-Arrays.html#Creating-Cell-Arrays" rel="next" title="Creating Cell Arrays">
<link href="Cell-Arrays.html#Cell-Arrays" rel="prev" title="Cell Arrays">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {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}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Basic-Usage-of-Cell-Arrays"></a>
<div class="header">
<p>
Next: <a href="Creating-Cell-Arrays.html#Creating-Cell-Arrays" accesskey="n" rel="next">Creating Cell Arrays</a>, Up: <a href="Cell-Arrays.html#Cell-Arrays" accesskey="u" rel="up">Cell Arrays</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Basic-Usage-of-Cell-Arrays-1"></a>
<h4 class="subsection">6.2.1 Basic Usage of Cell Arrays</h4>
<a name="index-_007b"></a>
<a name="index-_007d"></a>
<p>As an example, the following code creates a cell array containing a
string and a 2-by-2 random matrix
</p>
<div class="example">
<pre class="example">c = {"a string", rand(2, 2)};
</pre></div>
<p>To access the elements of a cell array, it can be indexed with the {
and } operators. Thus, the variable created in the previous example
can be indexed like this:
</p>
<div class="example">
<pre class="example">c{1}
⇒ ans = a string
</pre></div>
<p>As with numerical arrays several elements of a cell array can be
extracted by indexing with a vector of indexes
</p>
<div class="example">
<pre class="example">c{1:2}
⇒ ans = a string
⇒ ans =
0.593993 0.627732
0.377037 0.033643
</pre></div>
<p>The indexing operators can also be used to insert or overwrite elements
of a cell array. The following code inserts the scalar 3 on the
third place of the previously created cell array
</p>
<div class="example">
<pre class="example">c{3} = 3
⇒ c =
{
[1,1] = a string
[1,2] =
0.593993 0.627732
0.377037 0.033643
[1,3] = 3
}
</pre></div>
<p>Details on indexing cell arrays are explained in <a href="Indexing-Cell-Arrays.html#Indexing-Cell-Arrays">Indexing Cell Arrays</a>.
</p>
<p>In general nested cell arrays are displayed hierarchically as in the
previous example. In some circumstances it makes sense to reference
them by their index, and this can be performed by the <code>celldisp</code>
function.
</p>
<a name="XREFcelldisp"></a><dl>
<dt><a name="index-celldisp"></a>Function File: <em></em> <strong>celldisp</strong> <em>(<var>c</var>)</em></dt>
<dt><a name="index-celldisp-1"></a>Function File: <em></em> <strong>celldisp</strong> <em>(<var>c</var>, <var>name</var>)</em></dt>
<dd><p>Recursively display the contents of a cell array. By default the values
are displayed with the name of the variable <var>c</var>. However, this name
can be replaced with the variable <var>name</var>. For example:
</p>
<div class="example">
<pre class="example">c = {1, 2, {31, 32}};
celldisp (c, "b")
⇒
b{1} =
1
b{2} =
2
b{3}{1} =
31
b{3}{2} =
32
</pre></div>
<p><strong>See also:</strong> <a href="Terminal-Output.html#XREFdisp">disp</a>.
</p></dd></dl>
<p>To test if an object is a cell array, use the <code>iscell</code>
function. For example:
</p>
<div class="example">
<pre class="example">iscell (c)
⇒ ans = 1
iscell (3)
⇒ ans = 0
</pre></div>
<a name="XREFiscell"></a><dl>
<dt><a name="index-iscell"></a>Built-in Function: <em></em> <strong>iscell</strong> <em>(<var>x</var>)</em></dt>
<dd><p>Return true if <var>x</var> is a cell array object.
</p>
<p><strong>See also:</strong> <a href="Predicates-for-Numeric-Objects.html#XREFismatrix">ismatrix</a>, <a href="Creating-Structures.html#XREFisstruct">isstruct</a>, <a href="Cell-Arrays-of-Strings.html#XREFiscellstr">iscellstr</a>, <a href="Built_002din-Data-Types.html#XREFisa">isa</a>.
</p></dd></dl>
<hr>
<div class="header">
<p>
Next: <a href="Creating-Cell-Arrays.html#Creating-Cell-Arrays" accesskey="n" rel="next">Creating Cell Arrays</a>, Up: <a href="Cell-Arrays.html#Cell-Arrays" accesskey="u" rel="up">Cell Arrays</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|
