MemoryConstrained

✖
`MemoryConstrained`

✖

MemoryConstrained[expr,b]

evaluates expr, stopping if more than b bytes of memory are requested.

✖

MemoryConstrained[expr,b,failexpr]

returns failexpr if the memory constraint is not met.

Details

MemoryConstrained generates an interrupt to stop the evaluation of expr if the amount of additional memory requested during the evaluation of expr exceeds b bytes.
MemoryConstrained evaluates failexpr only if the evaluation is aborted.
MemoryConstrained returns $Aborted if the evaluation is aborted and no failexpr is specified.
Aborts generated by MemoryConstrained can be overruled by AbortProtect. »
MemoryConstrained[expr,Infinity] imposes no memory constraint.

Examples

open allclose all

Basic Examples (2)Summary of the most common use cases

In[1]:=1

✖

https://wolfram.com/xid/0h2iz35kuq-nv2

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0h2iz35kuq-ex8

Out[2]=2

Run a command until a memory limit is exceeded:

In[1]:=1

✖

https://wolfram.com/xid/0h2iz35kuq-ga4y2k

Out[1]=1

The loop ran until memory allocation for the result of Range exceeded the limit:

In[2]:=2

✖

https://wolfram.com/xid/0h2iz35kuq-byzajr

Out[2]=2

Scope (2)Survey of the scope of standard use cases

Specify the value to return if the time constraint is reached:

In[1]:=1

✖

https://wolfram.com/xid/0h2iz35kuq-dnbq8p

Out[1]=1

Use CheckAbort inside MemoryConstrained to select which parts are skipped if the limit is reached:

In[1]:=1

✖

https://wolfram.com/xid/0h2iz35kuq-3ql9m8

Out[1]=1

Properties & Relations (4)Properties of the function, and connections to other functions

The third argument is only evaluated if the memory limit is reached:

In[1]:=1

✖

https://wolfram.com/xid/0h2iz35kuq-lieade

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0h2iz35kuq-t4m0w9

Out[2]=2

A nested AbortProtect can block the action of MemoryConstrained:

In[1]:=1

✖

https://wolfram.com/xid/0h2iz35kuq-rpeft

Out[1]=1

An enclosing AbortProtect is overridden by MemoryConstrained:

In[1]:=1

✖

https://wolfram.com/xid/0h2iz35kuq-xd89xl

Out[1]=1

While code inside the MemoryConstrained is terminated, AbortProtect runs to completion:

In[2]:=2

✖

https://wolfram.com/xid/0h2iz35kuq-q6pyqn

Out[2]=2

MemoryConstrained can constrain the first argument of CheckAbort, but not the second:

In[1]:=1

✖

https://wolfram.com/xid/0h2iz35kuq-vicb1l

Out[1]=1

Top