Skip to content

nstrstr

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. It uses the file nstrnum_nstrstr.csd.

Example of the nstrstr opcode.
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
<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

Author: John ffitch
New in version 6.13
Written in the year 2019.