pushLocalFrame
Creates a new local reference frame, in which at least a given number of local references can be created.
Note that local references already created in previous local frames are still valid in the current local frame.
As with ensureLocalCapacity, some Java Virtual Machine implementations may choose to limit the maximum capacity, which may cause the function to throw an exception.
Since
JDK/JRE 1.2
Parameters
capacity
the minimum number of required local references. Must be > 0.
Throws
if fails.