TONE()

Sound a tone with a specified frequency and duration.

Syntax

TONE( <nFrequency>, <nDuration> ) --> NIL

Arguments

<nFrequency> A non-negative numeric value that specifies the frequency of the tone in hertz.

<nDuration> A positive numeric value which specifies the duration of the tone in 1/18 of a second units.

Returns

TONE() always returns NIL.

Description

TONE() is a sound function that could be used to irritate the end user, his or her dog, and the surrounding neighborhood. The frequency is clamped to the range 0 to 32767 Hz.

Examples

If lOk // Good Sound
TONE( 500, 1 )
TONE( 4000, 1 )
TONE( 2500, 1 )
Else // Bad Sound
TONE( 300, 1 )
TONE( 499, 5 )
TONE( 700, 5 )
EndIf

Tests


TONE( 800, 1 ) // same as ? CHR(7)
TONE( 32000, 200 ) // any dogs around yet?
TONE( 130.80, 1 ) // musical note - C
TONE( 400, 0 ) // short beep
TONE( 700 ) // short beep
TONE( 10, 18.2 ) // 1 second delay
TONE( -1 ) // 1/18.2 second delay
TONE( ) // 1/18.2 second delay

Tests

Status

Started

Compliance

TONE() works exactly like CA-Clipper's TONE().

Platforms

All

Files

Library is rtl

See Also