WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

CreateManagedLibraryExpression
✖
CreateManagedLibraryExpression

✖

creates a managed library expression by applying f to a positive integer ID associated with a registered manager with name mname.

Details

  • The IDs generated for the manager with name mname start at 1 and follow sequentially until the manager is unregistered.
  • A manager is registered by using the LibraryLink callback function registerLibraryExpressionManager.

Examples

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

Load example LibraryFunction objects that implement a simple linear congruential random generator:

In[1]:=1
✖
https://wolfram.com/xid/0tgrjb3f1rpr1god1hua-4s3oex

Create an instance of a linear congruential generator:

In[3]:=3
✖
https://wolfram.com/xid/0tgrjb3f1rpr1god1hua-eky732
Out[3]=3

Set its parameters using the unique ID assigned by CreateManagedLibraryExpression:

In[4]:=4
✖
https://wolfram.com/xid/0tgrjb3f1rpr1god1hua-mbgn2e

Generate two pseudorandom numbers from the instance:

In[5]:=5
✖
https://wolfram.com/xid/0tgrjb3f1rpr1god1hua-byhn50
Out[5]=5

Set up another instance and generate three numbers from it:

In[6]:=6
✖
https://wolfram.com/xid/0tgrjb3f1rpr1god1hua-r19fk1
Out[8]=8

The first instance is available until the expression is no longer referenced:

In[9]:=9
✖
https://wolfram.com/xid/0tgrjb3f1rpr1god1hua-cew139
Out[9]=9

The history expression Out will often keep references to an expression you may not be aware of. Extra references like this can be prevented by setting $HistoryLength=0 either in a session or inside of Block:

In[12]:=12
✖
https://wolfram.com/xid/0tgrjb3f1rpr1god1hua-hlt9d9
Out[13]=13

The variable g3 is the only reference to the managed library instance, so when g3 is unset, the library instance is freed and expressions with this ID will no longer work:

In[14]:=14
✖
https://wolfram.com/xid/0tgrjb3f1rpr1god1hua-bpzmeo
Out[14]=14

Note that the same does not work for g1 because it is referenced by Out:

In[17]:=17
✖
https://wolfram.com/xid/0tgrjb3f1rpr1god1hua-l5d0v4
Out[18]=18
Wolfram Research (2014), CreateManagedLibraryExpression, Wolfram Language function, https://reference.wolfram.com/language/ref/CreateManagedLibraryExpression.html.
✖
Wolfram Research (2014), CreateManagedLibraryExpression, Wolfram Language function, https://reference.wolfram.com/language/ref/CreateManagedLibraryExpression.html.

Text

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

✖
Wolfram Research (2014), CreateManagedLibraryExpression, Wolfram Language function, https://reference.wolfram.com/language/ref/CreateManagedLibraryExpression.html.

CMS

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

✖
Wolfram Language. 2014. "CreateManagedLibraryExpression." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/CreateManagedLibraryExpression.html.

APA

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

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

BibTeX

@misc{reference.wolfram_2025_createmanagedlibraryexpression, author="Wolfram Research", title="{CreateManagedLibraryExpression}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/CreateManagedLibraryExpression.html}", note=[Accessed: 18-June-2025 ]}

✖
@misc{reference.wolfram_2025_createmanagedlibraryexpression, author="Wolfram Research", title="{CreateManagedLibraryExpression}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/CreateManagedLibraryExpression.html}", note=[Accessed: 18-June-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_createmanagedlibraryexpression, organization={Wolfram Research}, title={CreateManagedLibraryExpression}, year={2014}, url={https://reference.wolfram.com/language/ref/CreateManagedLibraryExpression.html}, note=[Accessed: 18-June-2025 ]}

✖
@online{reference.wolfram_2025_createmanagedlibraryexpression, organization={Wolfram Research}, title={CreateManagedLibraryExpression}, year={2014}, url={https://reference.wolfram.com/language/ref/CreateManagedLibraryExpression.html}, note=[Accessed: 18-June-2025 ]}