<doc>
	<legacy_id>1442</legacy_id>
	<name>beep</name>
	<type>command</type>

	<syntax>
		<example>beep [<i>numberOfTimes</i>]</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Sounds the system beep.</summary>

	<examples>
<example>beep</example>
<example>beep 7</example>
<example><p>beep trunc(field &quot;Severity Level&quot;)</p></example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.5">Android Support Added</changed>
<changed version="4.5.2">iOS Support Added</changed>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<web/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Images &amp; Multimedia</category>
	</classification>

	<references>
		<command tag="play">play Command</command>
		<property tag="beepDuration">beepDuration Property</property>
		<property tag="beepLoudness">beepLoudness Property</property>
		<property tag="beepPitch">beepPitch Property</property>
		<property tag="playLoudness">playLoudness Property</property>
		<property tag="beepSound">beepSound Property</property>
	</references>

	<description>
	<overview>Use the <b>beep</b> command to get the user's attention.</overview>

		<parameters>
  <parameter>
    <name>numberOfTimes</name>
    <description>An integer (or an expression that evaluates to an integer) and specifies how many beeps are sounded. If the <i>numberOfTimes</i> is not specified, one beep is sounded.</description>
  </parameter>		</parameters>

	<value></value>
	<comments>If the <i>numberOfTimes</i> is less than 1, the <b>beep</b> command has no effect (but does not cause a <glossary tag="error">script error</glossary>).<p></p><p></p><cp_note><function tag="openStacks">Windows</function> and <glossary tag="OS X">OS X</glossary> do not <glossary tag="execute">execute</glossary> the <b>beep</b> command if it's issued while a beep is playing. This means that if you specify a <i>numberOfTimes</i> on a <function tag="openStacks">Windows</function> or <glossary tag="OS X">OS X system</glossary>, the user might hear fewer beeps because not all of them are sent to the speaker. To ensure that the user hears a specific number of beeps, use a <glossary tag="loop">loop</glossary> with a <command tag="wait">wait</command> command (where the wait time is at least as long as the beep sound's duration) after each beep:</cp_note><p></p><p></p><note>Overuse of the <b>beep</b> command has been known to cause user stress.</note><p></p><p></p><note>The iPhone has no default system alert sound so if a sound is required one must be specified using the <property tag="beepSound">beepSound</property> property. The action of <b>beep</b> is controlled by the system and depends on the user's preference settings. In particular a beep will only cause a vibration if the user has enabled that feature. Similarly, a beep will only cause a sound if the phone is not in silent mode.</note><p></p><p></p><note>Android tries to use the default NOTIFICATION sound or uses the RINGTONE sound, if the NOTIFICATION sound is not available.</note></p></comments>
	</description>
</doc>