ficlose

ficlose — Ferme un fichier ouvert précédemment.

Description

ficlose peut être utilisé pour fermer un fichier qui avait été ouvert avec fiopen.

Syntaxe

ficlose ihandle
ficlose Sfilename

Initialisation

ihandle -- un nombre qui identifie le fichier (généré par un fiopen précédent).

Sfilename -- une chaîne de caractères entre guillemets ou une variable chaîne de caractères contenant le nom du fichier. Il faut donner le chemin complet si le répertoire du fichier n'est pas dans le PATH (chemin) du système et s'il n'est pas dans le répertoire courant.

Exécution

ficlose ferme un fichier ouvert précédemment avec fiopen. ficlose n'est nécessaire que si l'on désire lire un fichier écrit durant la même exécution de Csound, car Csound ne sauve les données dans tous les fichiers ouverts et ne ferme ceux-ci que lorsqu'il termine une exécution. L'opcode ficlose est utile par exemple si l'on veut sauvegarder des presets dans des fichiers auquels on veut pouvoir accéder sans terminer Csound.

[Note] Note

Si l'on a pas besoin de cette fonctionnalité, il est plus sûr de ne pas appeler ficlose, et de laisser Csound fermer les fichiers lorsqu'il se termine.

Si un fichier fermé par ficlose est accédé par un autre opcode (comme fout ou foutk), il sera fermé plus tard lorsqu'il ne sera plus utilisé.

[Avertissement] Avertissement

Il faut utiliser cet opcode avec précaution, car l'identificateur de fichier n'est plus valide, et il y aura une erreur d'initialisation si un opcode essaie d'accéder au fichier fermé.

Exemples

Voici un exemple de l'opcode ficlose. Il utilise le fichier ficlose.csd.

Exemple 294. Exemple de l'opcode ficlose.

Voir les sections Audio en Temps Réel et Options de la Ligne de Commande pour plus d'information sur l'utilisation des options de la ligne de commande.

<CsoundSynthesizer> 
<CsOptions> 
; Select audio/midi flags here according to platform
-odac     ;;;realtime audio out
;-iadc    ;;;uncomment -iadc if realtime audio input is needed too
; For Non-realtime ouput leave only the line below:
; -o ficlose.wav -W ;;; for file output any platform
</CsOptions> 
<CsInstruments> 

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

gihand fiopen "test1.txt", 0 

instr 1

ires  random  0, 100
      fouti gihand, 0, 1, ires 
      ficlose gihand 

endin 
</CsInstruments> 
<CsScore> 

i 1 0 1 

e
</CsScore> 
</CsoundSynthesizer> 


Voir aussi

fiopen, fout, fouti, foutir, foutk

Crédits

Auteur : Gabriel Maldonado
Italie
1999

Nouveau dans la version 5.02 de Csound