<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>