readf
Prev | Orchestra Opcodes and Operators | Next

## readf

readf — Read a line of text from an external file.

## Description

Read a line of text from an external file once each k-cycle.

## Syntax

    Sres, kline readf ifilname

## Initialization

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.

## Performance

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.

## Examples

Here is an example of the readf opcode. It uses the file readf.csd.

Example 811. 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>

## See Also

readfi.

## Credits

John ffitch and Joachim Heintz

2012; new in 5.17.12

Prev | Up | Next
readclock | Home | readfi