newcclosure

newcclosure(fn: function, name: string?) -> function

​

Parameters

​

Returns

​

Behavior

• Already a C closure. If fn is already a C closure, it is returned unchanged, because there is nothing to wrap, so no new closure is created.
• Wrapper reuse. If you wrap the same source function again and the previous wrapper is still reusable, Athena returns that existing wrapper rather than minting a new one. This keeps identity stable across repeated wrapping.
• Environment carried over. The wrapper inherits the source function’s global environment, so getfenv/setfenv behavior is consistent between the two.
• Yields. The wrapper forwards yields correctly, so wrapping a yielding function keeps it yielding.

​

Example

local wrapped = newcclosure(function(...)
    print("called with", ...)
    return ...
end)

print(iscclosure(wrapped)) -- true
wrapped(1, 2, 3)           -- called with 1 2 3

​

Errors

​

Related

• newlclosure: a Luau wrapper instead of a C one.
• isnewcclosure: detect these wrappers.
• getwrappedoriginal: recover the wrapped function.