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