<html lang="en"> <head> <title>Cell Arrays in Oct-Files - Untitled</title> <meta http-equiv="Content-Type" content="text/html"> <meta name="description" content="Untitled"> <meta name="generator" content="makeinfo 4.13"> <link title="Top" rel="start" href="index.html#Top"> <link rel="up" href="Oct_002dFiles.html#Oct_002dFiles" title="Oct-Files"> <link rel="prev" href="Character-Strings-in-Oct_002dFiles.html#Character-Strings-in-Oct_002dFiles" title="Character Strings in Oct-Files"> <link rel="next" href="Structures-in-Oct_002dFiles.html#Structures-in-Oct_002dFiles" title="Structures in Oct-Files"> <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> <meta http-equiv="Content-Style-Type" content="text/css"> <style type="text/css"><!-- pre.display { font-family:inherit } pre.format { font-family:inherit } pre.smalldisplay { font-family:inherit; font-size:smaller } pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } span.sc { font-variant:small-caps } span.roman { font-family:serif; font-weight:normal; } span.sansserif { font-family:sans-serif; font-weight:normal; } --></style> </head> <body> <div class="node"> <a name="Cell-Arrays-in-Oct-Files"></a> <a name="Cell-Arrays-in-Oct_002dFiles"></a> <p> Next: <a rel="next" accesskey="n" href="Structures-in-Oct_002dFiles.html#Structures-in-Oct_002dFiles">Structures in Oct-Files</a>, Previous: <a rel="previous" accesskey="p" href="Character-Strings-in-Oct_002dFiles.html#Character-Strings-in-Oct_002dFiles">Character Strings in Oct-Files</a>, Up: <a rel="up" accesskey="u" href="Oct_002dFiles.html#Oct_002dFiles">Oct-Files</a> <hr> </div> <h4 class="subsection">A.1.4 Cell Arrays in Oct-Files</h4> <p>Octave's cell type is equally accessible within oct-files. A cell array is just an array of <code>octave_value</code>s, and so each element of the cell array can then be treated just like any other <code>octave_value</code>. A simple example is <pre class="example"><pre class="verbatim"> #include <octave/oct.h> #include <octave/Cell.h> DEFUN_DLD (celldemo, args, , "Cell Demo") { octave_value_list retval; int nargin = args.length (); if (nargin != 1) print_usage (); else { Cell c = args (0).cell_value (); if (! error_state) for (octave_idx_type i = 0; i < c.nelem (); i++) retval(i) = c.elem (i); } return retval; } </pre> </pre> <p>Note that cell arrays are used less often in standard oct-files and so the <samp><span class="file">Cell.h</span></samp> header file must be explicitly included. The rest of this example extracts the <code>octave_value</code>s one by one from the cell array and returns be as individual return arguments. For example consider <pre class="example"> [b1, b2, b3] = celldemo ({1, [1, 2], "test"}) ⇒ b1 = 1 b2 = 1 2 b3 = test </pre> </body></html>