fprints

fprints — Similar to prints but prints to a file.

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 files fprints.orc and fprints.sco.

Example 161. Example of the fprints opcode.

/* fprints.orc */
/* Written by Matt Ingalls, edited by Kevin Conder. */
; Initialize the global variables.
sr = 44100
kr = 4410
ksmps = 10
nchnls = 1

; Instrument #1 - a score generator example.
instr 1
  ; Print to the file "my.sco".
  fprints "my.sco", "%!Generated score by ma++\\n \\n"
endin
/* fprints.orc */

        
/* fprints.sco */
/* Written by Matt Ingalls, edited by Kevin Conder. */
; Play Instrument #1.
i 1 0 0.001
/* fprints.sco */

        

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

;Generated score by ma++
      

See Also

prints

Credits

Author: Matt Ingalls
January 2003