TAG( ) (Función)

Artículo
04/11/2008

Devuelve un nombre de etiqueta desde un archivo de índice compuesto de múltiples entradas .CDX abierto, o bien, el nombre de un archivo de índice de una sola entrada .IDX abierto.

TAG([CDXFileName[, nTagNumber[, nWorkArea | cTableAlias]]])

Valores devueltos

Character

Parámetros

CDXFileName
Especifica el nombre del archivo de índice .cdx compuesto de múltiples entradas desde el cual TAG( ) devuelve un nombre de etiqueta.
nTagNumber
Especifica un número correspondiente al orden en el que se creó la etiqueta en el archivo de índice compuesto. Por ejemplo, si nTagNumber es 1, TAG( ) devuelve el nombre de la primera etiqueta creada en el archivo de índice compuesto. Si nTagNumber es 2, TAG( ) devuelve el nombre de la segunda etiqueta creada y así sucesivamente. TAG( ) devolverá la cadena vacía cuando nTagNumber exceda el número de nombres de etiqueta.

Si omite CDXFileName, TAG( ) devuelve nombres de etiquetas de archivos de índice compuesto y nombre de archivo de índice de entrada única en un orden específico, de la siguiente forma.
- Se devuelven los nombres de los archivos de índice de entrada única según su orden en la cláusula INDEX de USE o SET INDEX.
- Se devuelven los nombres de las etiquetas del archivo de índice compuesto estructural (si hay uno para la tabla).
- Se devuelven los nombres de etiqueta de otros archivos de índice compuesto abiertos, otra vez en el orden de creación de las etiquetas en los archivos de índice compuesto y en el orden en que se especifican los archivos de índice compuesto en la cláusula INDEX de USE o SET INDEX.
nWorkArea | cTableAlias
Devuelve nombres de etiquetas y nombres de archivos de índice desde archivos abiertos en otra área de trabajo. El parámetro nWorkArea especifica un número de área de trabajo y cTableAlias especifica un alias de tabla. De forma predeterminada, se devuelven los nombres de etiquetas y los nombres de archivos de índice desde los archivos del área de trabajo activa.

Observaciones

Las etiquetas son entradas de índice de archivos de índice .cdx compuestos de múltiples entradas creados con INDEX.

Nota Los archivos de índice .cdx compuesto de múltiples entradas y los archivos de índice .idx de una sola entrada se pueden abrir para una tabla con la cláusula INDEX en USE o con SET INDEX. Con esta tabla se abre automáticamente un archivo de índice .cdx compuesto estructural.

Ejemplo

El ejemplo siguiente abre la tabla customer de la base de datos testdata. FOR ... ENDFOR para crear un bucle en el que CDX( ) se utiliza para mostrar el nombre de cada índice estructural.

CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'data\testdata')
USE Customer     && Open customer table

CLEAR
FOR nCount = 1 TO 254
   IF !EMPTY(TAG(nCount))  && Checks for tags in the index
   ? CDX(nCount)     && Display .CDX names
   ELSE
      EXIT  && Exit the loop when no more tags are found
   ENDIF
ENDFOR

Vea también

CDX( ) | INDEX | MDX( ) | NDX( ) | SET INDEX | SYS(14) - Expresión de índice | USE (Comando)

Share via