<doc>

<legacy_id>1663</legacy_id>

<name>divide</name>

<type>command</type>

<syntax>

<example>divide [<i>chunk</i> of] <i>container</i> by <i>number</i></example>

<example>divide <i>arrayContainer</i> by {<i>number</i> | <i>array</i>}</example>

</syntax>

<synonyms>

</synonyms>

<summary>Divides a <glossary tag="container">container</glossary> by a number and places the resulting <function tag="value">value</function> in the <glossary tag="container">container</glossary>.</summary>

<examples>

<example>divide field 1 by 52</example>

<example>divide field "Total Income" by 12</example>

<example><p>divide line x of field "Expenses" by percentageRate</p></example>

<example><p>put 100 into tValue</p><p>divide tValue by 2</p></example>

</examples>

<history>

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

<deprecated version=""></deprecated>

<removed version=""></removed>

<changed version="1.1">1.1</changed>

<experimental version=""></experimental>

<nonexperimental version=""></nonexperimental>

</history>

<objects>

</objects>

<platforms>

<mac/>

<windows/>

<linux/>

<ios/>

<android/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

<mobile/>

</classes>

<security>

</security>

<classification>

<category>Math, Logic, &amp; Dates</category>

</classification>

<references>

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

<operator tag="/">/ Operator</operator>

</references>

<description>Use the <b>divide</b> <glossary tag="command">command</glossary> to divide a <glossary tag="container">container</glossary> or a portion of a <glossary tag="container">container</glossary> by a number, or to divide two <glossary tag="array">arrays</glossary> containing numbers.<p></p><p><b>Parameters:</b></p><p>The <i>chunk</i> is a <glossary tag="chunk expression">chunk expression</glossary> specifying a portion of the <i>container</i>.</p><p></p><p>The <i>container</i> is a <keyword tag="field">field</keyword>, <keyword tag="button">button</keyword>, or <glossary tag="variable">variable</glossary>, or the <keyword tag="message box">message box</keyword>.</p><p></p><p>The <i>number</i> is any <glossary tag="expression">expression</glossary> that <glossary tag="evaluate">evaluates</glossary> to a number.</p><p></p><p><b>Comments:</b></p><p>The contents of the <i>container</i> (or the <i>chunk</i> of the <glossary tag="container">container</glossary>) must be a number or an <glossary tag="expression">expression</glossary> that <glossary tag="evaluate">evaluates</glossary> to a number.</p><p></p><p>If an <i>arrayContainer</i> is divided by a <i>number</i>, each element is divided by the <i>number</i>. If an <i>arrayContainer</i> is divided by an <i>array</i>, both <glossary tag="array">arrays</glossary> must have the same number of <glossary tag="element">elements</glossary> and the same dimension, and each <keyword tag="element">element</keyword> in the <i>arrayContainer</i> is divided by the corresponding <keyword tag="element">element</keyword> of the <i>array</i>.</p><p></p><p>If the <i>container</i> or an <keyword tag="element">element</keyword> of the <i>arrayContainer</i> is empty, the <b>divide</b> <glossary tag="command">command</glossary> treats its contents as zero.</p><p></p><p>If <i>container</i> is a <keyword tag="field">field</keyword> or <keyword tag="button">button</keyword>, the <function tag="format">format</function> of the result is determined by the <property tag="numberFormat">numberFormat</property> <glossary tag="property">property</glossary>.</p><p></p><p>Attempting to divide by zero causes an execution error.</p><p></p><p></p><change><p>Theform was introduced in version 1.1. In previous versions, only single numbers could be used with the <b>divide</b> <glossary tag="command">command</glossary>.</change></description>

</doc>