Description

Returns the string of a named instr from its number or an empty string if no such association exists.

Syntax

Sname nstrstr insno

Sname nstrstr knsno

Initialization

insno -- the instrument number of the named instrument.

Performance

knsno -- the named instrument's number.

Sname -- the named instrument's name.

If an instrument with the specified name does not exist an empty string is returned.

Examples

Here is an example of the nstrstr opcode. Play nstrnum_nstrstr.csd

<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
      

Credits