1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4 * Copyright (C) 2009 - DIGITEO - Vincent COUVERT
5 *
6 * Copyright (C) 2012 - 2016 - Scilab Enterprises
7 *
8 * This file is hereby licensed under the terms of the GNU GPL v2.0,
9 * pursuant to article 5.3.4 of the CeCILL v.2.1.
10 * This file was originally licensed under the terms of the CeCILL v2.1,
11 * and continues to be available under such terms.
12 * For more information, see the COPYING file which you should have received
13 * along with this program.
14 *
15 -->
16<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="m2sci_length">
17    <refnamediv>
18        <refname>length (Matlab function)</refname>
19        <refpurpose>Length of largest array dimension</refpurpose>
20    </refnamediv>
21    <refsection>
22        <title>Matlab/Scilab equivalent</title>
23        <informaltable border="1" width="100%">
24            <tr>
25                <td align="center">
26                    <emphasis role="bold">Matlab</emphasis>
27                </td>
28                <td align="center">
29                    <emphasis role="bold">Scilab</emphasis>
30                </td>
31            </tr>
32            <tr>
33                <td>
34                    <programlisting role="no-scilab-exec"><![CDATA[
35length(A)
36]]></programlisting>
37                </td>
38                <td>
39                    <programlisting role="no-scilab-exec"><![CDATA[
40max(size(A))
41]]></programlisting>
42                </td>
43            </tr>
44        </informaltable>
45    </refsection>
46    <refsection>
47        <title>Particular cases</title>
48        <para>
49            If <emphasis role="bold">A</emphasis> contains character strings, String matrix has to
50            be converted to a "character" string matrix using <emphasis role="bold">mstr2sci</emphasis>
51            (Using <emphasis role="bold">asciimat</emphasis> to convert will give the same result).
52        </para>
53        <warning>
54            Scilab <emphasis role="bold">length</emphasis>() is different from Matlab's
55            <emphasis role="bold">length</emphasis> function.
56        </warning>
57    </refsection>
58</refentry>
59