# 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

- CHR()
- SET BELL