readf — Read a line of text from an external file.
ifilname -- an integer N denoting a file named "input.N" or a character string (in double quotes, spaces permitted) denoting the external file name. For a string, it may either be a full path name with directory specified or a simple filename. In the later case, the file is sought first in the current directory, then in SSDIR, and finally in SFDIR.
Sres -- output of the line read from ifilname.
kline -- line number, or -1 when end of file has been reached.
This opcode allows a line of text to be read from a named external file. There may be any number of readf opcodes in an instrument or orchestra but they read separately from the same or different files.
Here is an example of the readf opcode. It uses the file readf.csd.
Example 742. Example of the readf opcode.
See the sections Real-time Audio and Command Line Flags for more information on using command line flags.
<CsoundSynthesizer> <CsOptions> -n </CsOptions> <CsInstruments> instr 1 Swd pwd printf_i "Working directory is '%s'\n", 1, Swd prints "Reading myself =):\n" read: Sline, kLinNum readf "readf.csd" printf "Line %d: %s", kLinNum, kLinNum, Sline if kLinNum != -1 then kgoto read else turnoff endif endin </CsInstruments> <CsScore> i1 0 1 e </CsScore> </CsoundSynthesizer>