TEXTVAR

Icône du lien vers le conceptVoir également Icône du lien vers le conceptExemple

Manipulation de chaînes de caractères.

Support WebVue - Oui.

Mode

Mnémonique

Syntaxe

1 BUFTOTEXT 1
2 TEXTTOBUF 1
3 FILETOTEXT 2
4 TEXTTOFILE 3
5 TEXTCOMPARE 4
6 TEXTCOPY 5
7 TEXTLEN 6

Syntaxe 1

IntVal = TEXTVAR(Mode, Text, Hbuf, Text_Offset, Hbuf_Offset, Size);

Type de retour : INTEGER

Argument

Définition

Text

Nom d'une variable texte. Type STR

Hbuf, Text_Offset, Hbuf_Offset,

Voir ci-dessous.

Size

Nombre de caractères à copier ou 0 pour tous les caractères.

Exécution

Mode

Mnémonique

Action

1

BUFTOTEXT

Copie le nombre de caractères spécifié par Taille du buffer spécifié par son handle But à partir du décalage But_Offset vers la variable texte Texte, décalé par Text_Offset.

2

TEXTTOBUF

Copie le nombre de caractères spécifié par Size à partir de la variable texte Text commençant à la position Text_Offset vers le buffer spécifié par son handle Hbuf et à partir de son offset Hbuf_Offset.

 

 

Retour : Le nombre de caractères copiés par la commande.

Syntaxe 2

IntVal = TEXTVAR(Mode, Text, Filename, Text_Offset, File_Offset, Size);

Type de retour : INTEGER

Argument

Définition

Text

Nom de la variable texte. Type STR.

Filename

Nom du fichier source.

Si exécutée dans le contexte d'une session WebVue, cette instruction est traitée par le back end web, en conséquence de quoi le fichier doit exister sur la machine back end web.

Text_Offset, File_Offset, Size

Voir ci-dessous.

Exécution

Mode

Mnémonique

Action

3

FILETOTEXT

Copie le nombre de caractères spécifié par Size à partir du fichier Filename commençant à la position File_Offset vers la variable texte Text, à partir de la position Text_offset.

Retour : Nombre de caractères copiés par la commande.

Syntaxe 3

IntVal = TEXTVAR(Mode, Text, Filename, Text_Offset, FileMode, Size);

Type de retour : INTEGER

Argument

Définition

Text

Nom de la variable texte. Type STR.

Filename

Nom du fichier destination. Si exécutée dans le contexte d'une session WebVue, cette instruction est traitée par le back end web, en conséquence de quoi le fichier sera créé sur la machine back end web.

Text_Offset, Size

Voir ci-dessous.

FileMode

0 Les caractères sont écrits au début du fichier et écrasent le contenu existant.

1 Les caractères sont ajoutés à la fin du fichier.

Exécution

Mode

Mnémonique

Action

4

TEXTTOFILE

Ecrit le nombre de caractères spécifié par Size à partir de la variable texte Text, commençant à la position Text_Offset vers le fichier Filename .

Retour : Nombre de caractères écrits par la commande.

Syntaxe 4

IntVal = TEXTVAR(Mode, Text1, Text2, size);

Type de retour : INTEGER

Argument

Définition

Text1

Nom de la variable texte. Type STR.

Text2

Nom d'une autre variable texte. Type STR.

size

Longueur de la valeur des variables texte à comparer. Type INTEGER.

Exécution

Mode

Mnémonique

Action

5

TEXTCOMPARE

Compare les chaînes de caractères des variables texte Text1 et Text2 selon le nombre de caractères spécifié dans Size.

Si size est invalide, les chaînes complètes seront comparées.

 

 

Retour :

Moins de 0 si l'extraction de Text1 < l'extraction de Text2

Plus que 0 si l'extraction de Text1 l'extraction de Text2

Plus que 0 si l'extraction de Text1 > l'extraction de Text2

Syntaxe 5

IntVal = TEXTVAR(Mode, Text1, Text2);

Type de retour : INTEGER

Argument

Définition

Text1

Nom de la variable texte. Type STR.

Text2

Nom d'une autre variable texte. Type STR.

Exécution

Mode

Mnémonique

Action

6

TEXTCOPY

Copie la variable Text2 vers Text1.

Retour : 1 si OK, 0 sinon.

Syntaxe 6

IntVal = TEXTVAR(Mode, Text);

Type de retour : INTEGER

Argument

Définition

Text

Nom d'une variable texte. Type STR.

Exécution

Mode

Mnémonique

Action

7

TEXTLEN

Renvoie la longueur de la chaîne de caractères contenue dans la variable texte.

Retour : La longueur en caractères de la chaîne Text.

Exemple

Cet exemple montre comment passer la valeur d'une variable à une variable de travail de type entier, et ensuite d'utiliser la variable de travail comme argument.

Dim iSize As Integer;

iSize =toi(@SIZE);

iReturn = Textvar("TEXTCOMPARE","@TEXT1","@TEXT2", iSize );

Pour plus d'exemples, sélectionnez le lien Exemple ci-dessus.