libpointer — Create a typed, session-owned native pointer value.
libpointer() creates a null voidPtr handle. libpointer(type) creates a null handle of the normalized C pointer type without allocating pointee storage. libpointer(type, value) allocates adapter-owned storage initialized from the value. The native adapter tracks origin-thread, session lifetime, and type metadata in every form.
Syntax
pointer = libpointer()
pointer = libpointer(type)
pointer = libpointer(type, value)Inputs
type- Type
Any- Required
- Yes
- Default
- —
- Description
- Scalar text, number, or logical normalized C pointer type.
value- Type
Any- Required
- Yes
- Default
- —
- Description
- Initializer validated against the declared C ABI element type and storage extent.
Returns
pointer- Type
Any- Description
- Session-owned native pointer handle.
Errors
RunMat:Foreign:UnsupportedOnWasm- When
- The current host cannot load a native shared library.
- Message
Native shared libraries are unavailable on this host.
RunMat:Foreign:InvalidCall- When
- Arguments do not satisfy the normalized shared-library contract.
- Message
Invalid shared-library operation.
RunMat:Foreign:HostUnavailable- When
- A native shared-library operation is invoked without an active runtime context.
- Message
Native shared-library operation has no active runtime context.
Type and storage
Accepted scalar pointer spellings include signed and unsigned fixed-width integers, logical, single, and double types. The declared C ABI type controls range checks; integer payloads are not silently converted through double storage. A returned borrowed pointer from calllib remains borrowed rather than becoming caller-owned through libpointer.
Example
Create exact integer pointer storage
p = libpointer('int32Ptr', int32(7));
assert(p.Value == int32(7));Using libpointer with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how libpointer changes the result.
Run a small libpointer example, explain the result, then change one input and compare the output.
FAQ
Does libpointer copy a C-returned pointer?⌄
No. Pointers returned from C keep their borrowed ownership and must be interpreted under the native adapter's handle contract.
Related Interop functions
Native
calllib · clibgen.buildInterface · libfunctions · libisloaded · libstruct · loadlibrary · setdatatype · unloadlibrary
Java
isjava · javaaddpath · javaArray · javaclasspath · javaMethod · javaMethodEDT · javaObject · javaObjectEDT · javarmpath · jenv · usejava
Source you can read
Every RunMat function's source is public. Read exactly how libpointer is executed, line by line, in Rust.
- View the source for libpointer in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.