/usr/share/doc/octave/octave.html/Basic-Usage-of-Cell-Arrays.html is in octave-doc 4.2.2-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Basic Usage of Cell Arrays (GNU Octave)</title>
<meta name="description" content="Basic Usage of Cell Arrays (GNU Octave)">
<meta name="keywords" content="Basic Usage of Cell Arrays (GNU Octave)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<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.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
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.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">
<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>: <em></em> <strong>celldisp</strong> <em>(<var>c</var>)</em></dt>
<dt><a name="index-celldisp-1"></a>: <em></em> <strong>celldisp</strong> <em>(<var>c</var>, <var>name</var>)</em></dt>
<dd><p>Recursively display the contents of a cell array.
</p>
<p>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>: <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>
|