PUT |
Fixe le point |
|---|---|
| QuickBASIC/QBasic | |
Syntaxe
| PUT [#]numFich%[,[numEnr&][,variable]] |
Paramètres
| Nom | Description |
|---|---|
| numFich% | Ce paramètre permet d'indiquer un numéro de Handle de l'identificateur de descripteur de fichier. Numéro utilisé dans l'instruction OPEN pour ouvrir le fichier. |
| numEnr& | Ce paramètre permet d'indiquer le numéro d'enregistrement dans le fichier. Pour les fichiers en mode aléatoire, le numéro de l'enregistrement à écrire. Pour les fichiers en mode binaire, la position de l'octet dans le fichier où l'écriture est effectuée. Le premier enregistrement d'un fichier est l'enregistrement 1. Si vous omettez numEnr, l'enregistrement ou l'octet suivant (celui après la dernière instruction GET ou PUT, ou celui vers lequel pointe la dernière SEEK) est écrit. Le numéro d'enregistrement le plus élevé possible est 2^31-1 ou 2 147 483 647. |
| variable | Ce paramètre permet d'indiquer la variable devant être écrite. L'instruction PUT écrit autant d'octets dans le fichier qu'il y a d'octets dans la variable. Si vous utilisez une variable, vous n'avez pas besoin d'utiliser MKI$, MKL$, MKS$ ou MKD$ pour convertir les champs numériques avant d'écrire. Vous ne pouvez pas utiliser une instruction FIELD avec le fichier si vous utilisez le paramètre variable. Pour les fichiers à accès aléatoire, vous pouvez utiliser n'importe quelle variable tant que la longueur de la variable est inférieure ou égale à la longueur de l'enregistrement. En général, une variable d'enregistrement définie pour correspondre aux champs d'un enregistrement de données est utilisée. Pour les fichiers en mode binaire, vous pouvez utiliser n'importe quelle variable. |
Description
Cette commande permet d'écrire une variable dans un fichier.
Remarques
- Vous pouvez omettre le numéro d'enregistrement, la variable ou les deux. Si vous omettez uniquement le numéro d'enregistrement, vous devez toujours inclure les virgules :
- Lors de l'utilisation d'un tampon de fichier défini par une instruction FIELD, LSET, RSET,
PRINT #, PRINT # USING et WRITE # peuvent être utilisés pour placer des caractères dans le tampon de
fichier aléatoire avant d'exécuter une instruction PUT. Dans le cas de WRITE #, le QuickBASIC remplit le tampon avec des espaces jusqu'au retour chariot.
Toute tentative de lecture ou d'écriture au-delà de la fin de la mémoire tampon provoque un message d'erreur :
FIELD overflow.
PUT #4,,FileBuffer
Si vous omettez les deux paramètres, vous n'incluez pas les virgules :
PUT #4
Les instructions GET et PUT permettent une entrée et une sortie de longueur fixe pour les fichiers de communication QuickBASIC. Soyez prudent lorsque vous utilisez GET et PUT pour les communications, car PUT écrit un nombre fixe de caractères et peut attendre indéfiniment en cas d'échec des communications.
Voir également
Langage de programmation - QuickBASIC/QBasic - Référence de procédures et de fonctions - GET
Langage de programmation - QuickBASIC/QBasic - Référence de procédures et de fonctions - FIELD
Langage de programmation - QuickBASIC/QBasic - Référence de procédures et de fonctions - LSET
Langage de programmation - QuickBASIC/QBasic - Référence de procédures et de fonctions - RSET
Langage de programmation - QuickBASIC/QBasic - Référence de procédures et de fonctions - TYPE
Langage de programmation - BASICA/GWBASIC - Référence de procédures et fonctions - PUT