Package org.pkl.core.runtime
Class VmFunction
java.lang.Object
org.pkl.core.runtime.VmValue
org.pkl.core.runtime.VmObjectLike
org.pkl.core.runtime.VmFunction
-
Nested Class Summary
Nested classes/interfaces inherited from class org.pkl.core.runtime.VmObjectLike
VmObjectLike.ForcedMemberValueConsumer, VmObjectLike.MemberValueConsumer -
Field Summary
Fields inherited from class org.pkl.core.runtime.VmObjectLike
enclosingFrame, extraStorage -
Constructor Summary
ConstructorsConstructorDescriptionVmFunction(com.oracle.truffle.api.frame.MaterializedFrame enclosingFrame, Object thisValue, int paramCount, PklRootNode rootNode, @Nullable Object extraStorage) -
Method Summary
Modifier and TypeMethodDescription<T> Taccept(VmValueConverter<T> converter, Iterable<Object> path) voidaccept(VmValueVisitor visitor) copy(int newParamCount, @Nullable PklRootNode newRootNode, @Nullable Object newExtraStorage) booleanEnables calling `vmValue.equals()` when not behind a Truffle boundary.export()Exports this object to an external representation.voidforce(boolean allowUndefinedValues) Forces recursive (deep) evaluation of this value.voidforce(boolean allowUndefinedValues, boolean recurse) Forces shallow or recursive (deep) evaluation of this object.booleanSame asVmObjectLike.iterateMemberValues(org.pkl.core.runtime.VmObjectLike.MemberValueConsumer)except that it first performs a shallowVmObjectLike.force(boolean, boolean).getCachedValue(Object key) Reads from the properties cache for this object.com.oracle.truffle.api.RootCallTargetAlways prefer this method over `getMembers().get(key)`.org.graalvm.collections.UnmodifiableEconomicMap<Object, ObjectMember> Returns the declared members of this object.intReturns the parent object in the prototype chain.booleanhasCachedValue(Object key) Prefer this method overVmObjectLike.getCachedValue(java.lang.Object)if the value is not required.inthashCode()booleanAlways prefer this method over `getMembers().containsKey(key)`.booleanbooleaniterateMembers(BiFunction<Object, ObjectMember, Boolean> consumer) Iterates over member definitions in order of their definition, from the top of the prototype chain downwards.booleanIterates over member definitions and their values in order of their definition, from the top of the prototype chain downwards.voidsetCachedValue(Object key, Object value) Writes to the properties cache for this object.Methods inherited from class org.pkl.core.runtime.VmObjectLike
getEnclosingFrame, getEnclosingOwner, getEnclosingReceiver, getExtraStorage, hasExtraStorage, isModuleObject, setExtraStorageMethods inherited from class org.pkl.core.runtime.VmValue
export, exportNullable, force, getPrototype, isDynamic, isListing, isMapping, isPrototype, isSequence, isTyped
-
Constructor Details
-
VmFunction
public VmFunction(com.oracle.truffle.api.frame.MaterializedFrame enclosingFrame, Object thisValue, int paramCount, PklRootNode rootNode, @Nullable @Nullable Object extraStorage)
-
-
Method Details
-
getCallTarget
public com.oracle.truffle.api.RootCallTarget getCallTarget() -
getParameterCount
public int getParameterCount() -
apply
-
apply
-
copy
public VmFunction copy(int newParamCount, @Nullable @Nullable PklRootNode newRootNode, @Nullable @Nullable Object newExtraStorage) -
getThisValue
-
getParent
Description copied from class:VmObjectLikeReturns the parent object in the prototype chain. For each concrete subclass X of VmObjectLike, the exact return type of this method is `X|VmTyped`.- Specified by:
getParentin classVmObjectLike
-
hasMember
Description copied from class:VmObjectLikeAlways prefer this method over `getMembers().containsKey(key)`.- Specified by:
hasMemberin classVmObjectLike
-
getMember
Description copied from class:VmObjectLikeAlways prefer this method over `getMembers().get(key)`.- Specified by:
getMemberin classVmObjectLike
-
getMembers
Description copied from class:VmObjectLikeReturns the declared members of this object.- Specified by:
getMembersin classVmObjectLike
-
getCachedValue
Description copied from class:VmObjectLikeReads from the properties cache for this object. The cache contains the values of all members defined in this object or an ancestor thereof which have been requested with this object as the receiver.- Specified by:
getCachedValuein classVmObjectLike
-
setCachedValue
Description copied from class:VmObjectLikeWrites to the properties cache for this object. The cache contains the values of all members defined in this object or an ancestor thereof which have been requested with this object as the receiver.- Specified by:
setCachedValuein classVmObjectLike
-
hasCachedValue
Description copied from class:VmObjectLikePrefer this method overVmObjectLike.getCachedValue(java.lang.Object)if the value is not required. (There is no point in calling this method to determine whether to callVmObjectLike.getCachedValue(java.lang.Object).)- Specified by:
hasCachedValuein classVmObjectLike
-
iterateMemberValues
Description copied from class:VmObjectLikeIterates over member definitions and their values in order of their definition, from the top of the prototype chain downwards. If a member value has not yet been evaluated, a `null` `value` is passed to `consumer`. If a member is defined in multiple objects in the prototype chain, i.e., is overridden along the way, it is visited only once, with the initial (i.e., upmost) `member` and the final (i.e., downmost) `value`. (This peculiar behavior serves two purposes in the current implementation: it guarantees that a `hidden` property is still recognized as such when overridden, and that an element is still recognized as such when overridden with entry syntax. It also means that members are visited in order of (first) definition.) Local, hidden, and external properties are not visited. If an invocation of `consumer` returns `false`, the remaining members are not visited, and `false` is returned. Otherwise, all members are visited, and `true` is returned.- Specified by:
iterateMemberValuesin classVmObjectLike
-
forceAndIterateMemberValues
Description copied from class:VmObjectLikeSame asVmObjectLike.iterateMemberValues(org.pkl.core.runtime.VmObjectLike.MemberValueConsumer)except that it first performs a shallowVmObjectLike.force(boolean, boolean). As a consequence, values passed toconsumerare guaranteed to be non-null.- Specified by:
forceAndIterateMemberValuesin classVmObjectLike
-
iterateAlreadyForcedMemberValues
- Specified by:
iterateAlreadyForcedMemberValuesin classVmObjectLike
-
iterateMembers
Description copied from class:VmObjectLikeIterates over member definitions in order of their definition, from the top of the prototype chain downwards. If a member is defined multiple times, each occurrence is visited. Local properties are not visited. If an invocation of `consumer` returns `false`, the remaining members are not visited, and `false` is returned. Otherwise, all members are visited, and `true` is returned.- Specified by:
iterateMembersin classVmObjectLike
-
getVmClass
- Specified by:
getVmClassin classVmValue
-
force
public void force(boolean allowUndefinedValues, boolean recurse) Description copied from class:VmObjectLikeForces shallow or recursive (deep) evaluation of this object.- Specified by:
forcein classVmObjectLike
-
force
public void force(boolean allowUndefinedValues) Description copied from class:VmValueForces recursive (deep) evaluation of this value. -
export
Description copied from class:VmObjectLikeExports this object to an external representation. Does not export local, hidden, or external properties- Specified by:
exportin classVmObjectLike
-
accept
-
accept
-
equals
Description copied from class:VmValueEnables calling `vmValue.equals()` when not behind a Truffle boundary. -
hashCode
public int hashCode()
-