<legacy_id>1099</legacy_id>

<name>accept</name>

<type>command</type>

<syntax>

<example>accept [datagram] connections on port <i>number</i> with message <i>callbackMessage</i></example>

</syntax>

<synonyms>

</synonyms>

<summary>Accepts an internet connection and creates a <glossary tag="socket">socket</glossary> for that connection.</summary>

<examples>

<example>accept connections on port 80 with message "connectionMade"</example>

<example><font face="courier new" size="17">accept datagram connections on port 80 with message "</font>connectionMade<font face="courier new" size="17">"</font></example>

<example><p>on mouseUp</p><p> accept connections on port 80 with message "connectionMade"</p><p>end mouseUp</p><p></p><p>on connectionMade pIPAddress</p><p> put "Connection made:" &amp;&amp; pIPAddress</p><p>end connectionMade</p></example>

</examples>

<history>

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

<deprecated version=""></deprecated>

<removed version=""></removed>

<experimental version=""></experimental>

<nonexperimental version=""></nonexperimental>

</history>

<objects>

</objects>

<platforms>

<mac/>

<windows/>

<linux/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

</classes>

<security>

<network/>

</security>

<classification>

<category>Networks &amp; Communication</category>

</classification>

<references>

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

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

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

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

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

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

<command tag="close socket">close socket Command</command>

<command tag="open socket">open socket Command</command>

<command tag="read from socket">read from socket Command</command>

<command tag="write to socket">write to socket Command</command>

<property tag="HTTPProxy">HTTPProxy Property</property>

</references>

<description>Use the <b>accept</b> <glossary tag="command">command</glossary> when running a <glossary tag="server">server</glossary>, to accept <glossary tag="TCP">TCP</glossary> connections or <glossary tag="UDP">UDP</glossary> <glossary tag="datagram">datagrams</glossary> from other systems (or other <glossary tag="process">processes</glossary> on the same system).<p>Use the datagram option if you want to accept UDP datagrams.</p><p></p><p><b>Parameters:</b></p><p>The <i>portNumber</i> is the <glossary tag="TCP">TCP</glossary> <glossary tag="port">port</glossary> number on which to accept connections.</p><p>The <i>callbackMessage</i> is the name of a <keyword tag="message box">message</keyword> to be sent when a connection is made or a <glossary tag="datagram">datagram</glossary> is received.</p><p></p><p><b>Comments:</b></p><p>When a connection is made or a datagram is received, the <b>accept</b> <glossary tag="command">command</glossary> creates a new <glossary tag="socket">socket</glossary> that can be used to communicate with the other system (or <glossary tag="process">process</glossary>). When using the <command tag="close socket">close socket</command>, <command tag="read from socket">read from socket</command>, or <command tag="write to socket">write to socket</command> <glossary tag="command">commands</glossary>, you can refer to this <glossary tag="socket">socket</glossary> with a socket identifier that looks like this:</p><p><i>host</i>:<i>port</i>[|<i>connectionID</i>]</p><p>where the <i>connectionID</i> is a number assigned by the <b>accept</b> <glossary tag="command">command</glossary>. (You only need to specify the connection number if there is more than one <glossary tag="socket">socket</glossary> connected to a particular <glossary tag="port">port</glossary> and <glossary tag="disabled">host</glossary>.)</p><p></p><p>The <i>callbackMessage</i> is sent to the <glossary tag="object">object</glossary> whose <property tag="script">script</property> contains the <b>accept</b> <glossary tag="command">command</glossary>. Either one or two <glossary tag="parameter">parameters</glossary> are sent with this <keyword tag="message box">message</keyword>. The first <glossary tag="parameter">parameter</glossary> is the <glossary tag="IP address">IP address</glossary> of the system or <glossary tag="process">process</glossary> making the connection. If a <glossary tag="datagram">datagram</glossary> is being accepted, the second <glossary tag="parameter">parameter</glossary> is the contents of the <glossary tag="datagram">datagram</glossary>.</p><p></p><p>For technical information about sockets, see RFC 147 at &lt;<u>http://www.ietf.org/rfc/rfc147.txt</u>&gt;.</p><p>For technical information about UDP datagrams, see RFC 768 at &lt;<u>http://www.ietf.org/rfc/rfc0768.txt</u>&gt;.</p><p>For technical information about the numbers used to designate standard ports, see the list of port numbers at &lt;<u>http://www.iana.org/assignments/port-numbers</u>&gt;<i>,</i> in particular the section entitled "Well Known Port Numbers".</p></description>

<legacy_id>1968</legacy_id>

<name>add</name>

<type>command</type>

<syntax>

<example>add <i>number</i> to [<i>chunk</i> of] <i>container</i></example>

<example>add {<i>number </i>| <i>array</i>} to <i>arrayContainer</i></example>

</syntax>

<synonyms>

</synonyms>

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

<examples>

<example>add 7 to field 1</example>

<example>add field "New" to tSummaryOfInventory</example>

<example><p>add (qty * price) to last line of tOrder</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/>

</classes>

<security>

</security>

<classification>

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

</classification>

<references>

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

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

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

</references>

<description>Use the <b>add</b> <glossary tag="command">command</glossary> to add a number to a <glossary tag="container">container</glossary> or a portion of a <glossary tag="container">container</glossary>, or to add two <glossary tag="array">arrays</glossary> containing numbers.<p></p><p><b>Parameters:</b></p><p>The <i>number</i> is an <glossary tag="expression">expression</glossary> that <glossary tag="evaluate">evaluates</glossary> to a number.</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>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>The <i>arrayContainer</i> is an <glossary tag="array">array</glossary> <glossary tag="variable">variable</glossary> each of whose <glossary tag="element">elements</glossary> is 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 <i>container</i>) 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 a <i>number</i> is added to an <i>arrayContainer</i>, the <i>number</i> is added to each <keyword tag="element">element</keyword>. If an <i>array</i> is added to an <i>arrayContainer</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>array</i> is added to the corresponding <keyword tag="element">element</keyword> of the <i>arrayContainer</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>add</b> <glossary tag="command">command</glossary> treats its contents as zero.</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 sum is determined by the <property tag="numberFormat">numberFormat</property> <glossary tag="property">property</glossary>.</p><p></p><p></p><change><p>The add to <i>arrayContainer</i> form was introduced in version 1.1. In previous versions, only single numbers could be used with the <b>add</b> <glossary tag="command">command</glossary>.</change></description>