RESTORE
 Lee variables de memoria de un fichero de memoria (.mem)
------------------------------------------------------------------------------
 Sintaxis

     RESTORE FROM <xcFicheroMem> [ADDITIVE]

 Argumentos

     <xcFicheroMem> es el fichero de memoria (.mem) que se va a cargar
     desde el disco. Si no se especifica una extensión, se supone la
     extensión .mem. El nombre de fichero puede especificarse como cadena
     literal o como expresión de caracteres encerrada entre paréntesis.

     ADDITIVE hace que las variables de memoria cargadas del fichero de
     memoria se añadan a la asignación de memoria de variables existente.

 Descripción

     RESTORE es un mandato de variables de memoria que vuelve a crear
     variables públicas y privadas guardadas previamente en un fichero de
     memoria (.mem) y las inicializa con sus valores anteriores. El ámbito
     de la variable no se guarda con ésta, sino que se establece de nuevo al
     recuperar la variable. Las matrices y las variables locales no pueden
     guardarse ni recuperarse.

     Cuando se recuperan variables de memoria, éstas vuelven a crearse como
     variables privadas cuyo ámbito es el procedimiento o la función actual
     definida por el usuario, a menos que ya existan como variables públicas
     y se especifique la cláusula ADDITIVE. Si se especifica ADDITIVE, las
     variables públicas y privadas que tengan el mismo nombre se
     sobreescriben, a no ser que se oculten antes con PRIVATE. Si no se
     especifica ADDITIVE, todas las variables públicas y privadas se liberan
     antes de cargar el fichero de memoria.

     Este mandato no afecta a las variables locales y estáticas. Si en el
     procedimiento o función actual se ha creado una variable local o
     estática y se recupera otra variable del mismo nombre, solamente es
     visible la variable local o estática, a no ser que las posteriores
     referencias a la variable recuperada vayan precedidas por el alias
     MEMVAR.

 Ejemplos

      Este ejemplo muestra una aplicación típica de SAVE y RESTORE.
        Aquí, las variables de memoria que contienen pantallas se guardan y
        recuperan en ficheros de memoria:

        // Crea y utiliza una pseudomatriz de pantallas
        SAVE SCREEN TO cPantalla1
        SAVE ALL LIKE cPantalla* TO Pantalla
        //
        <sentencias>...
        //
        RESTORE FROM Pantalla ADDITIVE
        nNumero = "1"
        RESTORE SCREEN FROM ("cPantalla" + nNumero)

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: LOCAL PRIVATE PUBLIC SAVE