filevalid

filevalid — Checks that a file can be used.

Description

Returns 1 if the sound file is valid, or 0 if not.

Syntax

ir filevalid ifilcod

Initialization

ifilcod -- sound file to be queried

Performance

filevalid returns 1 if the sound file ifilcod can be used.

Examples

Here is an example of the filevalid opcode. It uses the file filevalid.csd, and mary.wav.

Example 203. Example of the filevalid opcode.

See the sections Real-time Audio and Command Line Flags for more information on using command line flags.

<CsoundSynthesizer>
<CsOptions>
; Select audio/midi flags here according to platform
; Audio out   Audio in
-odac           -iadc    ;;;RT audio I/O
; For Non-realtime ouput leave only the line below:
; -o filelen.wav -W ;;; for file output any platform
</CsOptions>
<CsInstruments>

; Initialize the global variables.
sr = 44100
kr = 4410
ksmps = 10
nchnls = 1

; Instrument #1.
instr 1
  ; Check that the audio file "mary.wav" is avalable
  ivld  filevalid "mary.wav"
  print ivld
endin


</CsInstruments>
<CsScore>

; Play Instrument #1 for 0.1 second.
i 1 0 0.1
e


</CsScore>
</CsoundSynthesizer>


See Also

filebit, filelen, filenchnls, filepeak, filesr

Credits

Author: Matt Ingalls
July 2010

Example written by John ffitch.

New in Csound version 4.13