nstrnum — Returns the number of a named instrument.
"name" -- the named instrument's name.
If an instrument with the specified name does not exist, an init error occurs, and -1 is returned.
Here is an example of the nstrnum opcode. It uses the file nstrnum_nstrstr.csd.
Example 668. Example of the nstrnum opcode.
See the sections Real-time Audio and Command Line Flags for more information on using command line flags.
<CsoundSynthesizer> <CsOptions> -n </CsOptions> <CsInstruments> sr = 44100 ksmps = 32 nchnls = 2 0dbfs = 1 instr nothing endin instr john prints "instrument name = " puts nstrstr(p1),1 prints "instrument number = %d\n", nstrnum("john") endin instr test endin </CsInstruments> <CsScore> i "john" 0 0 </CsScore> </CsoundSynthesizer>
The example will produce the following output:
instrument name = john instrument number = 2