The Alternative Csound Reference Manual
Previous |  | Next

# cggoto

cggoto -- Conditionally transfer control on every pass.

## Description

Transfer control to label on every pass. (Combination of cigoto and ckgoto)

## Syntax

cggoto condition, label

where label is in the same instrument block and is not an expression, and where R is one of the Relational operators (<, =, <=, ==, !=) (and = for convenience, see also under Conditional Values).

## Examples

Here is an example of the cggoto opcode. It uses the files cggoto.orc and cggoto.sco.

Example 1. Example of the cggoto opcode.

    /* cggoto.orc */
    ; Initialize the global variables.
    sr = 44100
    kr = 4410
    ksmps = 10
    nchnls = 1

    ; Instrument #1.
    instr 1
      i1 = 1

      ; If i1 is equal to one, play a high note.
      ; Otherwise play a low note.
      cggoto (i1 == 1), highnote

    lownote:
      a1 oscil 10000, 220, 1
      goto playit

    highnote:
      a1 oscil 10000, 440, 1
      goto playit

    playit:
      out a1
    endin
    /* cggoto.orc */

    /* cggoto.sco */
    ; Table #1: a simple sine wave.
    f 1 0 32768 10 1

    ; Play Instrument #1 for one second.
    i 1 0 1
    e
    /* cggoto.sco */

## See Also

cigoto, ckgoto, cngoto, if, igoto, kgoto, tigoto, timout

## Credits

Added a note by Jim Aikin.

Example written by Kevin Conder.

Previous | Home | Next
cent | Up | chanctrl