<doc>

<legacy_id>2491</legacy_id>

<name>extents</name>

<type>function</type>

<syntax>

<example>the extents of <i>array</i></example>

<example>extents(<i>array</i>)</example>

</syntax>

<synonyms>

</synonyms>

<summary>Returns a list of the smallest and largest <function tag="keys">keys</function> for each dimension of an <glossary tag="array">array</glossary>.</summary>

<examples>

<example><p>the extents of myArray</p></example>

<example><p>put item 1 of line 2 of the extents of theFigures into columnsMinimum</p></example>

</examples>

<history>

<introduced version="1.1">Added. </introduced>

<deprecated version=""></deprecated>

<removed version=""></removed>

</history>

<objects>

</objects>

<platforms>

<mac/>

<windows/>

<linux/>

<ios/>

<android/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

<mobile/>

</classes>

<security>

</security>

<classification>

<category>Values &amp; Properties</category>

</classification>

<references>

<function tag="sum">sum Function</function>

<function tag="matrixMultiply">matrixMultiply Function</function>

<function tag="max">max Function</function>

<function tag="min">min Function</function>

<function tag="round">round Function</function>

<function tag="keys">keys Function</function>

<command tag="combine">combine Command</command>

<command tag="split">split Command</command>

</references>

<description>

<overview>Use the <b>extents</b> <control_st tag="function">function</control_st> to find the minimum and maximum row and column numbers of an <glossary tag="array">array</glossary> whose <function tag="keys">keys</function> are <glossary tag="integer">integers</glossary>. </overview>

<parameters><p>The <i>array</i> is any <glossary tag="array">array</glossary> of any dimension whose <function tag="keys">keys</function> are numbers.</p></parameters>

<value>The <b>extents</b> function returns one <keyword tag="line">line</keyword> for each dimension of the <glossary tag="array">array</glossary>. </p><p></p><p>Each line contains two numbers separated by commas. The first item is the lowest key number in that dimension, and the second item is the highest key number. </p></value>

<comments>If any of the keys of the <i>array</i> is non-numeric, the <b>extents</b> <control_st tag="function">function</control_st> returns empty.</comments>

</description>

</doc>