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