APPEND FROM ARRAY

APPEND FROM ARRAY (Comando)

Agrega a la tabla seleccionada actualmente un registro por cada fila de una matriz y llena cada registro con datos de la fila correspondiente de la matriz.

Sintaxis

APPEND FROM ARRAY NombreMatriz

  [FOR lExpresión]

  [FIELDS ListaCampos]

  | FIELDS LIKE Estructura

  | FIELDS EXCEPT Estructura

Argumentos

NombreMatriz

Especifica el nombre de la matriz que contiene los datos que se van a copiar a los nuevos registros. Se agregan nuevos registros a la tabla hasta que se hayan anexado todas las filas de la matriz.

FOR lExpresión

Especifica una condición para anexar registros desde la matriz. lExpresión debe contener el nombre de un campo de destino en su expresión condicional.

Antes de que una fila de la matriz se anexe a un registro de la tabla, se comprueba el elemento de matriz correspondiente al campo de destino especificado en lExpresión para determinar si cumple la condición de lExpresión. Si el elemento de matriz satisface la condición, se anexa un registro.

Si el elemento de matriz no satisface la condición, la fila de matriz no se anexa y se comprueba la fila siguiente de la matriz para determinar si cumple la condición.

FIELDS ListaCampos

Especifica que sólo los campos de ListaCampos se actualizan a partir de la matriz. El primer campo de la lista se actualiza con el contenido del primer elemento de la matriz, el segundo campo se actualiza con el segundo elemento, etcétera.

FIELDS LIKE Estructura

Especifica que los campos que coincidan con la estructura de campos Estructura se actualizan a partir de la matriz.

FIELDS EXCEPT Estructura

Especifica que todos los campos excepto los que coincidan con la estructura de campos Estructura se actualizan a partir de la matriz.

La estructura de campos Estructura admite caracteres comodín. Por ejemplo, para especificar que todos los campos que comiencen con las letras A y P se actualizan de la matriz, utilice lo siguiente:

APPEND FROM ARRAY aMiMatriz FIELDS LIKE A*,P*

Puede combinar la cláusula LIKE con la cláusula EXCEPT:

APPEND FROM ARRAY aMiMatriz FIELDS LIKE A*,P* EXCEPT PARTNO*

Comentarios

Los campos memo y general se pasan por alto en APPEND FROM ARRAY. Cuando se abre una tabla para uso compartido, APPEND FROM ARRAY bloquea el encabezado de la tabla mientras se agregan los registros.

Si la matriz es de una dimensión, APPEND FROM ARRAY agregará un registro a la tabla. El contenido del primer elemento de la matriz llena el primer campo del nuevo registro agregado, el contenido del segundo elemento de la matriz llena el segundo campo del registro y así sucesivamente.

Si la matriz de una dimensión tiene más elementos que campos tenga la tabla, los elementos adicionales se pasarán por alto. Si la tabla tiene más campos que elementos la matriz, los campos adicionales se inicializarán con el valor vacío predeterminado. Éstos son los valores vacíos predeterminados para cada tipo de campo:

Tipo de campo

Valor predeterminado

Carácter

Espacios

Numérico

0

Moneda

0

Flotante

0

Entero

0

Doble

0

Fecha

Fecha vacía (p. ej. CTOD(""))

FechaHora

FechaHora vacía (p. ej. CTOT(""))

Lógico

Falso (.F.)

Memo

Vacío (sin contenido)

Si la matriz es de dos dimensiones, APPEND FROM ARRAY agregará un nuevo registro a la tabla por cada fila de la matriz. Por ejemplo, si la matriz tiene cuatro filas, se anexarán cuatro nuevos registros a la tabla.

El contenido de la primera columna de la matriz llena el primer campo de los nuevos registros anexados, la segunda columna

...