dbase Instruction Tag()

TAG()

Instruction dBase IV et suivants

Renvoie le nom d'un fichier index .NDX ou d'un repère d'index de fichier .MDX.

Syntaxe

TAG( [<fichier .mdx expC>,] <numéro d'index expN> [,<alias>] )

<fichier .mdx expC>

Le nom d'un fichier index multiple dans lequel un repère doit être cherché à la position <numéro d'index expN>.

<numéro d'index expN>

Le numéro du fichier index .NDX ouvert ou du repère d'index dans le fichier index multiple dont vous voulez renvoyer le nom.

<alias>

Un numéro de zone de travail (1 à 225), une lettre de zone de travail (A à J) ou un nom d'alias. La lettre de zone de travail ou le nom d'alias doit être entouré de guillemets.

Note : Contrairement à la plupart des fonctions, le premier paramètre est facultatif. Si vous omettez le premier paramètre, les paramètres restants se déplacent d'un vers l'avant; le deuxième paramètre est le premier paramètre, et ainsi de suite.

Description

TAG( ) renvoie le nom d'un fichier .NDX ou d'un repère .MDX pour l'index spécifié par <numéro d'index expN>. Le numéro d'index indique la position d'un index dans la liste des index ouverts dans la zone de travail en cours ou la zone de travail spécifiée avec les commandes USE et SET INDEX. Si aucun numéro d'index n'est spécifié, TAG( ) renvoie le nom de l'index maître.

Si vous spécifiez un nom de fichier .MDX, TAG( ) renvoie les noms de repères apparaissant dans le fichier index multiple spécifié. L'ordre des repères d'index dans le fichier index multiple détermine l'ordre dans lequel TAG( ) renvoie les noms de repères.

Si vous ne spécifiez pas de nom de fichier .MDX, TAG( ) renvoie le nom de repère dans la liste d'index ouverts et vérifie d'abord les fichiers .NDX. TAG( ) vérifie ensuite les repères d'index d'exploitation .MDX et enfin les autres fichiers .MDX ouverts, dans l'ordre de leur ouverture.

Si aucun index ni repère d'index n'existe à l'emplacement spécifié, TAG( ) renvoie une chaîne vide ("").a

xDML vers ooDML

Le langage XBase a quelques fonctions utilisées pour retourner des informations sur des balises d'index. Selon l'aide en ligne, il n'y a pas d'équivalent direct en OODML pour TAG(), TAGCOUNT() et TAGNO().

Toutefois, l'objet TableDef dans DB2K vous permet d'afficher cette information avec très peu d'efforts.

t = new TableDef()

t.tableName := "mytable"

t.load()

? t.indexes.size // TAGCOUNT() equivalent

? t.indexes[1].indexName // TAG() equivalent

// TAGNO() est un peu plus compliqué

cTagName = "TAGNAME" // Recherche TagName

nTagNo = 0

for i = 1 to t.indexes.size

if t.indexes[ i ].indexName == cTagName

nTagNo = i

exit

endif

? nTagNo

Code

Dans l'exemple suivant, TAG( ) permet de déterminer les noms des fichiers index ouverts pour la table en cours :

USE SOCIETE EXCLUSIVE

INDEX ON C_SOCIETE TAG C_SOCIETE

INDEX ON SOCIETE TAG SOCIETE

INDEX ON CODE_POST TAG CODE_POST

* 3 index, au moins, existent dans SOCIETE.MDX.

FOR i=1 TO TAGCOUNT( )

* TAGCOUNT( ) représente le

* nombre total d'index dans SOCIETE.MDX

? "Repère",i, TAG(i)

NEXT i

dUFLP :

IndexTags.cc

Classe conçue pour permettre au développeur d'obtenir un tableau d'informations sur un fichier d'index .MDX, ou de permettre à un utilisateur de sélectionner une balise d'index à partir d'un formulaire qui affiche les noms des index et des expressions

retour

Sources :

Aide Visual dbase V5.7
http://www.dbase.com/Knowledgebase/INT/xb2vdb7oodml/x2oodml.htm par Ken Mayer
Aide dBase Plus 2.6.0

dUflp version W

Retour à l'accueil

Si vous voyez des erreurs, ou souhaitez apporter des compléments, n'hésitez pas à le signaler.
Dernière modification : lundi 09 août 2010