Share via

BLANK (Comando)

  • Artículo

Borra datos de todos los campos del registro activo cuando se ejecuta sin argumentos.

BLANK [FIELDS FieldList] [Scope] [FOR lExpression1] [WHILE lExpression2]
   [NOOPTIMIZE] [IN nWorkArea | cTableAlias]

Parámetros

  • FIELDS FieldList
    Sólo borra a los campos especificados mediante FieldList. Si omite la cláusula FIELDS, todos los campos de un registro se borrarán de forma predeterminada. Cualquier campo que especifique de un área de trabajo no seleccionada deberá ir precedido del alias del área de trabajo.

    Nota   BLANK no borrará datos de campo de un registro situado en otra área de trabajo relacionada si el puntero de registro se encuentra al final del archivo en el área de trabajo actual. El puntero de registro debe estar situado en un registro del área de trabajo actual para que BLANK actúe sobre los campos del registro relacionado.

  • Scope
    Especifica un intervalo de registros que se va a borrar. Sólo se borrarán aquellos registros comprendidos dentro de ese intervalo. Las cláusulas de alcance son: ALL, NEXT nRecords, RECORD nRecordNumber y REST.

    Para obtener más información acerca de las cláusulas de alcance, vea el tema Scope (Cláusulas). Los comandos que incluyen Scope sólo actúan sobre la tabla del área de trabajo activa.

    Para obtener más información acerca de las cláusulas de alcance, vea el tema Introducción al lenguaje. Los comandos que incluyen Scope sólo actúan sobre la tabla del área de trabajo activa.

    El alcance predeterminado para BLANK es el registro actual (NEXT 1).

  • FOR lExpression1
    Borra los datos de campos de aquellos registros para los que lExpression1 dé como resultado verdadero (.T.). Rushmore optimizará BLANK FOR si lExpression1 es una expresión optimizable. Puede ver una explicación de la optimización Rushmore en Usar Rushmore para agilizar el acceso a los datos.

  • WHILE lExpresion2
    Especifica una condición según la cual los datos de campo de los registros se borrarán siempre y cuando la expresión lógica lExpression2 dé como resultado verdadero (.T.).

  • NOOPTIMIZE
    Impide la optimización Rushmore de BLANK. Si desea obtener más información, vea SET OPTIMIZE y Usar Rushmore para agilizar el acceso a los datos.

  • IN nWorkArea | cTableAlias
    Especifica el área de trabajo o el alias de tabla al que afecta el comando BLANK. Utilice esta cláusula para especificar un área de trabajo o una tabla fuera del área de trabajo actual.

Observaciones

Utilice APPEND BLANK para agregar un nuevo registro en blanco al final de una tabla. Utilice ISBLANK( ) para determinar si un campo de un registro está en blanco.

Ejemplo

El ejemplo siguiente abre la tabla customer de la base de datos testdata. Se muestra el contenido del primer registro. SCATTER se utiliza para guardar el contenido de dicho registro en una matriz. El registro se borra con BLANK y se vuelve a mostrar el contenido del registro. Se utiliza GATHER para restaurar el contenido original del registro y el contenido restaurado vuelve a mostrarse.

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

CLEAR
DISPLAY  && Displays the current record
SCATTER TO gaCustomer  && Create array with record contents
BLANK  && Clear the record
DISPLAY  && Displays the blank record 
GATHER FROM gaCustomer  && Restore original record contents
DISPLAY  && Display the restored record

Vea también

APPEND | EMPTY( ) | ISBLANK( ) | REPLACE | SET OPTIMIZE | Usar Rushmore para agilizar el acceso a los datos