Description

Similar to prints but prints to a file.

Syntax

fprints "filename", "string" [, ival1] [, ival2] [...]

Initialization

"filename" -- name of the output file.

"string" -- the text string to be printed. Can be up to 8192 characters and must be in double quotes.

ival1, ival2, ... (optional) -- The i-rate values to be printed. These are specified in “string” with the standard C value specifier (%f, %d, etc.) in the order given.

Performance

fprints is similar to the prints opcode except it outputs to a file. For more information about output formatting, please look at printks's documentation.

Examples

Here is an example of the fprints opcode. It uses the file fprints.csd. Note that the example must be run from a directory for which the user has write access.

<CsoundSynthesizer>
<CsOptions>
; Select audio/midi flags here according to platform
; Audio out   Audio in
-n   ; no sound
; For Non-realtime ouput leave only the line below:
; -o fprints.wav -W ;;; for file output any platform
</CsOptions>
<CsInstruments>

; by Matt Ingalls, edited by Kevin Conder. 

sr = 44100
ksmps = 32
nchnls = 2
0dbfs  = 1

instr 1     ; a score generator
  
fprints "my.sco", "%!Generated score by ma++\\n \\n"    ; Print to the file "my.sco".

endin

</CsInstruments>
<CsScore>
i 1 0 0.001
e
</CsScore>
</CsoundSynthesizer>

This example will generate a file called “my.sco”. It should contain a line like this:

;Generated score by ma++
      

See also

File Input and Output

Credits