Internal Function for Data Editing
DESCRIPTION:
An internal function used by the S-PLUS for Windows data editor.
This function is for internal use only, users are not expected to ever
call it.
USAGE:
undo(name, where=1, new.name=name, new.where=where, initial=F)
REQUIRED ARGUMENTS:
- name
-
a character string giving the name of the object to be restored.
OPTIONAL ARGUMENTS:
- where
-
an integer specifying the database position
or a character string specifying the S-PLUS database name
where the restored object is to be found.
- new.name
-
a character string giving the new name to use for the restored object.
- new.where
-
an integer specifying the database position
or a character string specifying the S-PLUS database name
where the restored object will be assigned.
- initial
-
a logical value, if
TRUE
, the value of the object
name
will be restored from the
__init
location of
where
.
If
FALSE
the object will be restored from the
__prev
location of
where
.
VALUE:
TRUE
if the restore was successful, otherwise
FALSE
.
SIDE EFFECTS:
If successful, an object,
new.name,
is created
in
new.where
.
EXAMPLES:
# the undo() function should never be called by users