forget - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Programming : Procedures and Functions : Remember Tables : forget

forget

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

forget( f, opts )

forget( f, a, b, c, ..., opts )

Parameters

f

-

procedure or module; the object to forget

a, b, c, ...

-

(optional) specific argument sequence for f

opts

-

options of the form keyword = true or false, where keyword is one of subfunctions, forgetpermanent or reinitialize

Description

• 

The forget function is used to clear remember tables of procedures.  Its precise action is controlled by the options given, whether f is a procedure or a module, and whether the remember table(s) in question is a pure remember table or a cache table.

• 

The options are:

– 

subfunctions = true or false (default: true)

If true, this causes forget(f) to also forget procedures related to f.  If f is a module, this means all procedures in the module, including procedures in submodules.  If f is a procedure which is not in a module, this means all procedures whose name is of the form f/.... If subfunctions=false and f is a an appliable module, only the remember table associated to the ModuleApply member of f is cleared. If subfunctions=false and f is a procedure which is not a module member, only the remember table associated to f itself is cleared. This option is ignored in the case when f is a procedure which is a module member.

– 

forgetpermanent = true or false (default: false)

If true then permanent entries in cache-based remember tables are also removed. If not given, or given as forgetpermanent=false, only temporary entries in cache-based remember tables are cleared. This option is ignored for non-cache-based remember tables.

– 

reinitialize = true or false (default: true)

This option only applies to the case when f is a procedure which is not a member of a module. In this case, if reinitialize=true, the corresponding procedure f is completely discarded and reloaded from its Maple archive, causing its remember table to be restored to its initial state.

• 

forget(f, a, b, c, ..., opts) restricts the action of forget to clearing only remember table entry(s) indexed by the argument list [a, b, c, ...], and subject to the interpretations implied by the options in opts.

• 

As a special case, specifying f as an empty range allows for selective clearing of remember table entries from all remember tables in the system.  This requires a second argument, to indicate which entries to clear. For example, forget(..,x), which will clear all remembered entries in the system that reference x.  

Examples

forgetevalc

sinx;sinπ

sinx

0

(1)

op4,opsin

Cache512,'temporary'=x=sinx,x=sinx,'permanent'=0=0,π=0,∞=undefined,∞=undefined,14π=122,I=Isinh1,16π=12,12π=1,13π=123

(2)

forgetsin,x,subfunctions=false

op4,opsin

Cache512,'temporary'=x=sinx,'permanent'=0=0,π=0,∞=undefined,∞=undefined,14π=122,I=Isinh1,16π=12,12π=1,13π=123

(3)

forgetsin,subfunctions=false

op4,opsin

Cache512,'permanent'=0=0,π=0,∞=undefined,∞=undefined,14π=122,I=Isinh1,16π=12,12π=1,13π=123

(4)

forgetsin,forgetpermanent,reinitialize=false

op4,opsin

Cache512

(5)

forgetLinearAlgebra

See Also

appliable

archive

cache

module

option

procedure

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam