Skip to content

remove

Removes the definition of an instrument as long as it is not in use.

Syntax

remove(insnum)
remove(definition)
remove insnum
remove definition

Initialization

insnum -- number or name of the instrument to be deleted

definition is an InstrDef. This form is available in Csound 7.

remove runs at initialization. It removes the compiled definition and its inactive instances. Remove it only after all its instances have finished. Csound rejects removal if it finds instances still in use.

Wait until every note that uses the definition has finished, and cancel any pending events that would use it. Do not use references to a removed definition or its instances afterward. For cleanup when the containing instrument ends, use delete.

See also

delete, create, Instrument definitions, instances and opcode objects

Credits

Author: John ffitch
University of Bath/Codemist Ltd.
Bath, UK
June, 2006

New in Csound version 5.04