AFIELDS( ) (Función)

Incluye en una matriz información acerca de la estructura de la tabla actual y devuelve el número de campos de la tabla.

AFIELDS(ArrayName [, nWorkArea | cTableAlias])

Valores devueltos

Numeric

Parámetros

• ArrayName
  Especifica una matriz en la que se incluye información acerca de la estructura de la tabla. Si la matriz que incluye en AFIELDS( ) no existe, Visual FoxPro la creará automáticamente. Si la matriz existe y no es suficientemente grande para contener toda la información devuelta por AFIELDS( ), el tamaño de la matriz aumentará automáticamente para dar cabida a la información.

• nWorkArea
  Especifica el área de trabajo de la tabla cuya información de estructura se almacena en una matriz.

• cTableAlias
  Especifica el alias de la tabla cuya información de estructura se coloca en una matriz.

  Si omite nWorkArea y cTableAlias, la información de la estructura se colocará en una matriz para la tabla en el área de trabajo seleccionada actualmente.

  La tabla siguiente describe el contenido de cada columna de la primera fila de la matriz y el tipo de datos de la información almacenada en cada columna. Los valores de las propiedades específicas de tabla de las columnas 10 a 16 sólo aparecerán en la primera fila de la matriz. Se crea una fila para cada campo de la tabla.

  Número de columna	Información de campo	Tipo de datos
  1	Nombre de campo	Character
  2	Tipo de campo:C = CharacterD = DateL = LogicalM = MemoN = NumericF = FloatI = IntegerB = DoubleY = CurrencyT = DateTimeG = General	Character
  3	Ancho del campo	Numérico
  4	Posiciones decimales	Numérico
  5	Valores nulos permitidos	Lógicas
  6	Conversión de página de códigos no permitida	Lógicas
  7	Regla de validación del campo	Character
  8	Texto de validación del campo	Character
  9	Valor predeterminado del campo	Character
  10	Regla de validación de la tabla	Character
  11	Texto de validación de la tabla	Character
  12	Nombre largo de tabla	Character
  13	Expresión del desencadenador Insert	Character
  14	Expresión del desencadenador Update	Character
  15	Expresión del desencadenador Delete	Character
  16	Comentario de tabla	Character

Observaciones

AFIELDS( ) devuelve el número de campos de la tabla. La matriz contiene 16 columnas y el mismo número de filas que campos hay en la tabla.

Puede utilizar COPY STRUCTURE EXTENDED para incluir información similar en una tabla, en vez de incluirla en una matriz.

Ejemplo

El ejemplo siguiente crea una matriz denominada gaMyArray que contiene información acerca de los campos de la tabla customer. Se muestran los nombres de los campos.

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

gnFieldcount = AFIELDS(gaMyArray)  && Create array
CLEAR
FOR nCount = 1 TO gnFieldcount 
   ? gaMyArray(nCount,1)  && Display field names
ENDFOR

Vea también

ADEL( ) | ADIR( ) | AELEMENT( ) | AINS( ) | ALEN( ) | ALTER TABLE – SQL | ASCAN( ) | ASORT( ) | ASUBSCRIPT( ) | COPY STRUCTURE EXTENDED | CREATE | CREATE TABLE | DIMENSION