ManagedObject

✖
`ManagedObject`

[Experimental]

✖

ManagedObject[…]

represents a managed object.

Details

ManagedObject is returned by functions such as CreateManagedObject.
Only active managed objects evaluate the freeing function when they are no longer referenced.
Managed objects can be inactivated with UnmanageObject.
Information for a ManagedObject may include the following properties:
"Active" True if the object is actively being managed

"BaseValue" the base value

"FreeingFunction" the freeing function

"Value" the value
Properties can be accessed with ManagedObject[…][prop].
Properties that can be extracted include all Information properties listed above.
Many functions that expect pointer objects will automatically unwrap managed expressions containing pointers.

Examples

open allclose all

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

Create a managed object:

In[1]:=1

✖

https://wolfram.com/xid/05e9yu7qmq-d1y9g6

Out[1]=1

Get the contained expression:

In[2]:=2

✖

https://wolfram.com/xid/05e9yu7qmq-nh79ni

Out[2]=2

f[expr] is evaluated once the managed object is no longer referenced:

In[1]:=1

✖

https://wolfram.com/xid/05e9yu7qmq-kk53zz

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

Information (1)

Create a managed object:

In[1]:=1

✖

https://wolfram.com/xid/05e9yu7qmq-foy396

Out[1]=1

Get Information about the object:

In[2]:=2

✖

https://wolfram.com/xid/05e9yu7qmq-mffoz6

Out[2]=2

Get the value of the managed object:

In[3]:=3

✖

https://wolfram.com/xid/05e9yu7qmq-j20rsp

Out[3]=3

Get the freeing function of the object:

In[4]:=4

✖

https://wolfram.com/xid/05e9yu7qmq-jqd047

Out[4]=4

List the operations available to this object:

In[5]:=5

✖

https://wolfram.com/xid/05e9yu7qmq-2gi9pf

Out[5]=5

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

Create a managed object:

In[1]:=1

✖

https://wolfram.com/xid/05e9yu7qmq-2b12aa

Out[1]=1

To stop managing the object, use UnmanageObject:

In[2]:=2

✖

https://wolfram.com/xid/05e9yu7qmq-yazsg4

Out[2]=2

The ManagedObject is no longer active:

In[3]:=3

✖

https://wolfram.com/xid/05e9yu7qmq-zsgwia

Out[3]=3

Functions like RawMemoryAllocate return a managed RawPointer:

In[1]:=1

✖

https://wolfram.com/xid/05e9yu7qmq-fx5yl9

Out[1]=1

The freeing function is RawMemoryFree:

In[2]:=2

✖

https://wolfram.com/xid/05e9yu7qmq-4ziof5

Out[2]=2

Export a string as raw memory:

In[1]:=1

✖

https://wolfram.com/xid/05e9yu7qmq-9fh5e8

Out[1]=1

Read the value stored in the pointer:

In[2]:=2

✖

https://wolfram.com/xid/05e9yu7qmq-u9eesj

Out[2]=2

Many functions will automatically unwrap managed pointers:

In[3]:=3

✖

https://wolfram.com/xid/05e9yu7qmq-vch09u

Out[3]=3

Top