Écrire

Écrit dans un fichier texte.

Structure

Écrire( [var F : Texte ; ] P1 [ , P2,..., Pn] );

Paramètres

Description

La fonction Write écrit une ou plusieurs valeurs dans un fichier texte. F, si elle est spécifiée, est une variable de fichier texte. Si F est omis, on utilise par défaut la variable de fichier standard Output. Chaque P est un paramètre d'écriture. Chaque paramètre d'écriture comprend une expression de sortie dont la valeur doit être écrite dans le fichier. Un paramètre d'écriture peut également contenir les spécifications relatives à la largeur d'un champ et au nombre de décimales. Chaque expression de sortie doit être de type Char, d'un des types entiers (Byte, Shortint, Word, Longint, Cardinal), d'un des types à virgule flottante (Single, Real, Double, Extended, Currency), d'un des types de chaîne (PChar, AnsiString, ShortString), d'une chaîne compressée ou d'un des types booléens (Boolean, Bool).

Un paramètre d'écriture se présente sous la forme

OutExpr [: MinWidth [: DecPlaces ] ]

où OutExpr est une expression de sortie. MinWidth et DecPlaces sont des expressions de type entier.

MinWidth spécifie la largeur minimale du champ, qui doit être supérieure à 0. Le nombre exact de caractères MinWidth est écrit (en ajoutant des espaces en début de chaîne si nécessaire), sauf si OutExpr a une valeur qui doit être représentée par plus de MinWidth caractères. Dans ce cas, un nombre suffisant de caractères est écrit pour représenter la valeur de OutExpr. De même, si MinWidth est omis, le nombre de caractères nécessaire est affiché pour représenter la valeur de OutExpr.

DecPlaces spécifie le nombre de décimales dans une représentation en virgule fixe de l'un des types Real. Cette option ne peut être spécifiée que si OutExpr est de type réel et si MinWidth est également spécifié. Lorsque MinWidth est spécifié, il doit être supérieur ou égal à 0.

Écrire avec une valeur de type caractère :

Si MinWidth est omis, la valeur sous forme de chaîne de caractères de OutExpr est écrite dans le fichier. Sinon, la valeur « MinWidth - 1 » espaces suivie de la valeur sous forme de caractère de « OutExpr » est écrite.

Écrivez l'une des valeurs de type entier :

Si MinWidth est omis, la représentation décimale de OutExpr est écrite dans le fichier sans espaces précédents. Si MinWidth est spécifié et que sa valeur est supérieure à la longueur de la chaîne décimale, un nombre suffisant d'espaces est inséré avant la chaîne décimale pour que la largeur du champ atteigne MinWidth.

Écrivez l'une des valeurs de type suivantes :

Si OutExpr prend une valeur de type réel, sa représentation décimale est écrite dans le fichier. Le format de la représentation dépend de la présence ou de l'absence de DecPlaces.

Si DecPlaces est omis (ou s'il est présent mais prend une valeur négative), une chaîne décimale à virgule flottante est générée. Si MinWidth est également omis, une valeur par défaut de 17 est utilisée ; sinon, si MinWidth est inférieur à 8, il est considéré comme égal à 8. Le format de la chaîne de caractères à virgule flottante est

[ | - ] <digit>. <décimales> E [ + | - ] <exposant>

Le tableau suivant répertorie les éléments de la chaîne de sortie.

Élément Signification

[ | - ] « » ou « - », selon le signe de OutExpr

<> de chiffre Un seul chiffre, « 0 » uniquement si OutExpr est égal à 0

<décimales> Chaîne de caractères contenant MinWidth-7 chiffres (mais au maximum 10)

Caractère E majuscule [E]

[ + | - ] Selon le signe de l'exposant

<exposant> Exposant décimal à deux chiffres

Si DecPlaces est présent, une chaîne décimale en virgule fixe est générée. Si DecPlaces est supérieur à 11, il est considéré comme égal à 11. Le format de la chaîne en virgule fixe est le suivant :

[ <espaces> ] [ - ] <chiffres> [ . <décimales>]

Le tableau suivant répertorie les composants de la chaîne en virgule fixe.

Élément Signification

[ <espaces> ] Espaces pour respecter la largeur minimale

[ - ] Si OutExpr est négatif

<chiffres> Au moins un chiffre, mais pas de zéros en tête

[ . <décimales> ] Décimales si DecPlaces > 0

Écrivez l'une des valeurs de type chaîne :

Si MinWidth est omis, la valeur sous forme de chaîne de OutExpr est écrite dans le fichier sans espaces en début de ligne. Si MinWidth est spécifié et que sa valeur est supérieure à la longueur de OutExpr, un nombre suffisant d'espaces est inséré avant la chaîne décimale afin que la largeur du champ soit égale à MinWidth.

Écrire avec une valeur de type chaîne compressée :

Si OutExpr est de type chaîne compressée, l'effet est le même que si l'on écrivait une chaîne dont la longueur correspond au nombre d'éléments du type chaîne compressée.

Écrivez l'une des valeurs de type booléen suivantes :

Si OutExpr est de type booléen, l'effet est le même que si l'on écrivait les chaînes « True » ou « False », selon la valeur de OutExpr.

Remarque

Lors de l'utilisation de la fonction « Écrire », le fichier doit être ouvert en mode écriture. |