WOLFRAM

Wolfram Language & System Documentation Center

ManagedObject[…]

represents a managed object.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Information  
Properties & Relations  
See Also
Tech Notes
Related Guides
History
Cite this Page

ManagedObject

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 all close all

Basic Examples  (2)

Create a managed object:

Wolfram Language code: man = CreateManagedObject[foo, Echo]

Get the contained expression:

Wolfram Language code: man["Value"]

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

Wolfram Language code: With[{man = CreateManagedObject[foo, Echo]}, Null]

Scope  (1)

Information  (1)

Create a managed object:

Wolfram Language code: obj = CreateManagedObject[foo, Echo]

Get Information about the object:

Wolfram Language code: info = Information[obj]

Get the value of the managed object:

Wolfram Language code: info["Value"]

Get the freeing function of the object:

Wolfram Language code: info["FreeingFunction"]

List the operations available to this object:

Wolfram Language code: info["Operations"]

Properties & Relations  (3)

Create a managed object:

Wolfram Language code: man = CreateManagedObject[foo, Echo]

To stop managing the object, use UnmanageObject:

Wolfram Language code: UnmanageObject[man]

The ManagedObject is no longer active:

Wolfram Language code: man["Active"]

Functions like RawMemoryAllocate return a managed RawPointer:

Wolfram Language code: ptr = RawMemoryAllocate["UnsignedInteger8"]

The freeing function is RawMemoryFree:

Wolfram Language code: ptr["FreeingFunction"]

Export a string as raw memory:

Wolfram Language code: man = RawMemoryExport["A string"]

Read the value stored in the pointer:

Wolfram Language code: RawMemoryRead[man["Value"]]

Many functions will automatically unwrap managed pointers:

Wolfram Language code: RawMemoryRead[man]
Wolfram Research (2023), ManagedObject, Wolfram Language function, https://reference.wolfram.com/language/ref/ManagedObject.html.

Text

Wolfram Research (2023), ManagedObject, Wolfram Language function, https://reference.wolfram.com/language/ref/ManagedObject.html.

CMS

Wolfram Language. 2023. "ManagedObject." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/ManagedObject.html.

APA

Wolfram Language. (2023). ManagedObject. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ManagedObject.html

BibTeX

@misc{reference.wolfram_2026_managedobject, author="Wolfram Research", title="{ManagedObject}", year="2023", howpublished="\url{https://reference.wolfram.com/language/ref/ManagedObject.html}", note=[Accessed: 12-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_managedobject, organization={Wolfram Research}, title={ManagedObject}, year={2023}, url={https://reference.wolfram.com/language/ref/ManagedObject.html}, note=[Accessed: 12-June-2026]}