gov.nasa.arc.brahms.vm.api.common
Interface IActiveInstance

All Superinterfaces:
IActiveConcept, IConcept, IType, IUserDefinedType
All Known Subinterfaces:
IAgent, IObject

public interface IActiveInstance
extends IActiveConcept

An ActiveInstance is a generic concept that indicates that the instance can have behavior. It is a concept that can reason with beliefs or facts and can perform activities.

Version:
$Revision: 1.2 $ $Date: 2009/11/29 21:37:35 $ $Author: rnado $
Author:
Ron van Hoof

Field Summary
 
Fields inherited from interface gov.nasa.arc.brahms.vm.api.common.IUserDefinedType
UDT
 
Method Summary
 boolean acquireMemoryReference(IContext ctx)
          Has the calling agent acquire a reference to this IActiveInstance indicating that it wishes to use this reference and to ensure that this IActiveInstance will not get deleted.
 void addBeliefRelationConcept(IConcept lhsConcept, java.lang.String relationName, IConcept rhsConcept, IContext ctx)
          Adds a concept as a value of a named relation for a concept by asserting a new belief into the belief state.
 void assertBelief(IBelief belief, IContext ctx)
          Schedules the assertion of the specified belief to the active instance's belief set.
 void assertBeliefs(IBelief[] beliefs, IContext ctx)
          Schedules the assertion of the specified beliefs to the active instance's belief set.
 void deregisterForMonitoring()
          Deregisters this agent with the agent monitor to no longer have this agent monitored for unexpected termination and failures.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, boolean value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, byte value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, char value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, double value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, float value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, IConcept value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, boolean value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, byte value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, char value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, double value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, float value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, IConcept value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, int value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, int value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, IUnknown value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, long value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, java.lang.Object value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, java.io.Serializable value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, short value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, java.lang.String value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, IUnknown value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, long value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, java.lang.Object value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, java.io.Serializable value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, short value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, int relop, java.lang.String value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, boolean value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, byte value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, char value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, double value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, float value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, IConcept value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, int value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, IUnknown value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, long value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, java.lang.Object value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, java.io.Serializable value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, short value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, java.lang.String value, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IRelation relation, IConcept rhsConcept, int truthValue, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBelief(IConcept lhsConcept, IRelation relation, IUnknown rhsConcept, int truthValue, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 boolean getBeliefAttributeBoolean(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves a boolean value for an attribute of a concept from a belief in the belief state
 boolean getBeliefAttributeBoolean(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves a boolean value for a collection attribute of a concept at a given integer index from a belief in the belief state
 boolean getBeliefAttributeBoolean(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves a boolean value for a collection attribute of a concept at a given String key from a belief in the belief state
 byte getBeliefAttributeByte(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves a byte value for an attribute of a concept from the active instance's belief state
 byte getBeliefAttributeByte(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves a byte value for a collection attribute of a concept at a given integer index from a belief in the belief state
 byte getBeliefAttributeByte(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves a byte value for a collection attribute of a concept at a given String key from a belief in the belief state
 char getBeliefAttributeChar(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves a char value for an attribute of a concept from the active instance's belief state
 char getBeliefAttributeChar(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves a char value for a collection attribute of a concept at a given integer index from a belief in the belief state
 char getBeliefAttributeChar(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves a char value for a collection attribute of a concept at a given String key from a belief in the belief state
 IConcept getBeliefAttributeConcept(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves an IConcept value for an attribute of a concept from a belief in the belief state
 IConcept getBeliefAttributeConcept(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves an IConcept value for a collection attribute of a concept at a given integer index from a belief in the belief state
 IConcept getBeliefAttributeConcept(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves an IConcept value for a collection attribute of a concept at a given String key from a belief in the belief state
 double getBeliefAttributeDouble(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves a double value for an attribute of a concept from a belief in the belief state
 double getBeliefAttributeDouble(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves a double value for a collection attribute of a concept at a given integer index from a belief in the belief state
 double getBeliefAttributeDouble(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves a double value for a collection attribute of a concept at a given String key from a belief in the belief state
 float getBeliefAttributeFloat(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves a float value for an attribute of a concept from the active instance's belief state
 float getBeliefAttributeFloat(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves a float value for a collection attribute of a concept at a given integer index from a belief in the belief state
 float getBeliefAttributeFloat(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves a float value for a collection attribute of a concept at a given String key from a belief in the belief state
 int getBeliefAttributeInt(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves an int value for an attribute of a concept from the active instance's belief state
 int getBeliefAttributeInt(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves an int value for a collection attribute of a concept at a given integer index from a belief in the belief state
 int getBeliefAttributeInt(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves an int value for a collection attribute of a concept at a given String key from a belief in the belief state
 java.io.Serializable getBeliefAttributeJava(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves a Serializable value for an attribute of a concept from a belief in the belief state
 java.io.Serializable getBeliefAttributeJava(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves a Serializable value for a collection attribute of a concept at a given integer index from a belief in the belief state
 java.io.Serializable getBeliefAttributeJava(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves a Serializable value for a collection attribute of a concept at a given String key from a belief in the belief state
 long getBeliefAttributeLong(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves a long value for an attribute of a concept from a belief in the belief state
 long getBeliefAttributeLong(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves a long value for a collection attribute of a concept at a given integer index from a belief in the belief state
 long getBeliefAttributeLong(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves a long value for a collection attribute of a concept at a given String key from a belief in the belief state
 java.util.Map<java.lang.Object,java.lang.Object> getBeliefAttributeMap(IConcept lhsConcept, java.lang.String attributeName, boolean includeUnknown, IContext ctx)
          Returns a Map representing the values for a map attribute of a concept from beliefs in the belief state Entries with values of unknown are included in the returned Map if the includeUnknown parameter is true.
 short getBeliefAttributeShort(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves a short value for an attribute of a concept from the active instance's belief state
 short getBeliefAttributeShort(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves a short value for a collection attribute of a concept at a given integer index from a belief in the belief state
 short getBeliefAttributeShort(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves a short value for a collection attribute of a concept at a given String key from a belief in the belief state
 java.util.SortedMap<java.lang.Object,java.lang.Object> getBeliefAttributeSortedMap(IConcept lhsConcept, java.lang.String attributeName, boolean includeUnknown, IContext ctx)
          Returns a sorted Map representing the values for a map attribute of a concept from beliefs in the belief state Entries with values of unknown are included in the returned Map if the includeUnknown parameter is true.
 java.lang.String getBeliefAttributeString(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves a String value for an attribute of a concept from a belief in the belief state The attribute's Brahms type may be either string or symbol.
 java.lang.String getBeliefAttributeString(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves a String value for a collection attribute of a concept at a given integer index from a belief in the belief state The Brahms type of the value may be either string or symbol.
 java.lang.String getBeliefAttributeString(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves a String value for a collection attribute of a concept at a given String key from a belief in the belief state The Brahms type of the value may be either string or symbol.
 java.lang.Object getBeliefAttributeValue(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Retrieves the value for an attribute of a concept from a belief in the belief state Returns null if there is no corresponding belief in the belief state.
 java.lang.Object getBeliefAttributeValue(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Retrieves the value for a collection attribute of a concept at a given integer index from a belief in the belief state Returns null if there is no corresponding belief in the belief state.
 java.lang.Object getBeliefAttributeValue(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Retrieves the value for a collection attribute of a concept at a given String key from a belief in the belief state Returns null if there is no corresponding belief in the belief state.
 IBelief getBeliefForIndex(IConcept lhsConcept, IAttribute lhsAttribute, int lhsCollectionIndex, int relop, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 IBelief getBeliefForIndex(IConcept lhsConcept, IAttribute lhsAttribute, java.lang.String lhsCollectionIndex, int relop, IContext ctx)
          Find the belief using the specified parameters and return the belief if found, null if the belief was not found.
 java.util.List<IConcept> getBeliefRelationConcepts(IConcept lhsConcept, java.lang.String relationName, IContext ctx)
          Retrieves a list of concepts that are related to a given concept by a named relation by inspecting the beliefs in the current belief state.
 java.util.Enumeration getBeliefs(IAttribute lhsAttribute, IContext ctx)
          Returns a list of all the beliefs that have the specified attribute on their left hand side regardless of their lhs concept, relational operator or value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side regardless of their relational operator or value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, boolean value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, byte value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, char value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, double value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, float value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, IConcept value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side and that use the specified relational operator.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, int value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, IUnknown value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, long value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, java.lang.Object value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, java.io.Serializable value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, short value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IAttribute lhsAttribute, int relop, java.lang.String value, IContext ctx)
          Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IRelation relation, IContext ctx)
          Returns a list of all the beliefs that have the specified left hand side concept and relation regardless of their right hand side concept.
 java.util.Enumeration getBeliefs(IConcept lhsConcept, IRelation relation, int truthvalue, IContext ctx)
          Returns a list of all the beliefs that have the specified left hand side concept, relation and truth value regardless of their right hand side concept.
 java.util.Enumeration getBeliefs(IContext ctx)
          Returns the active instance's belief set.
 java.util.Enumeration getBeliefs(IRelation relation, IConcept rhsConcept, int truthvalue, IContext ctx)
          Returns a list of all the beliefs that have the specified relation and right hand side concept, and truth value regardless of their left hand side concept.
 java.util.Enumeration getBeliefs(IRelation relation, IContext ctx)
          Returns a list of all the beliefs that have the specified relation regardless of their left and right hand side concept.
 java.util.Enumeration getBeliefs(IRelation relation, IUnknown rhsConcept, int truthvalue, IContext ctx)
          Returns a list of all the beliefs that have the specified relation, as right hand side 'unknown', and the specified truth value regardless of their left hand side concept.
 boolean hasBeliefAttributeAnyValue(IConcept lhsConcept, java.lang.String attributeName, boolean includeUnknown, IContext ctx)
          Tests whether a concept has any value for a named attribute based on the beliefs in the belief state.
 boolean hasBeliefAttributeAnyValue(IConcept lhsConcept, java.lang.String attributeName, int index, boolean includeUnknown, IContext ctx)
          Tests whether a concept has any value for a named collection attribute at a given integer index based on the beliefs in the belief state.
 boolean hasBeliefAttributeAnyValue(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, boolean includeUnknown, IContext ctx)
          Tests whether a concept has any value for a named collection attribute at a given String key based on the beliefs in the belief state.
 boolean hasBeliefAttributeValue(IConcept lhsConcept, java.lang.String attributeName, int index, java.lang.Object value, IContext ctx)
          Tests whether a concept has a specified value for a named attribute based on the beliefs in the belief state.
 boolean hasBeliefAttributeValue(IConcept lhsConcept, java.lang.String attributeName, java.lang.Object value, IContext ctx)
          Tests whether a concept has a specified value for a named attribute based on the beliefs in the belief state.
 boolean hasBeliefAttributeValue(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, java.lang.Object value, IContext ctx)
          Tests whether a concept has a specified value for a named attribute based on the beliefs in the belief state.
 boolean hasBeliefRelationAnyValue(IConcept lhsConcept, java.lang.String relationName, boolean includeUnknown, IContext ctx)
          Tests whether there are any true beliefs for a given concept and named relation in the current belief state.
 boolean hasBeliefRelationValue(IConcept lhsConcept, java.lang.String relationName, java.lang.Object value, IContext ctx)
          Tests whether a concept is related to a value by a named relation by inspecting the beliefs in the current belief state.
 void registerForMonitoring()
          Registers this agent with the agent monitor to have this agent monitored for unexpected termination and failures.
 void releaseMemoryReference(IContext ctx)
          Has the calling agent release a reference to this IActiveInstance indicating that it no longer wishes to use this reference and to allow for this IActiveInstance to be deleted.
 java.util.List<IConcept> removeAllBeliefRelationValues(IConcept lhsConcept, java.lang.String relationName, IContext ctx)
          Removes any existing concepts as values of a named relation for a concept by retracting beliefs from the belief state.
 void removeBeliefRelationConcept(IConcept lhsConcept, java.lang.String relationName, IConcept rhsConcept, IContext ctx)
          Removes a concept as a value of a named relation for a concept by retracting the corresponding belief from the belief state.
 void retractBelief(IBelief belief, IContext ctx)
          Schedules the retraction of the specified belief from the active instance's belief set.
 void setBeliefAttributeBoolean(IConcept lhsConcept, java.lang.String attributeName, boolean value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified boolean value for a named attribute
 void setBeliefAttributeBoolean(IConcept lhsConcept, java.lang.String attributeName, int index, boolean value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified boolean value for a named collection attribute at an int index
 void setBeliefAttributeBoolean(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, boolean value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified boolean value for a named collection attribute at a String key
 void setBeliefAttributeByte(IConcept lhsConcept, java.lang.String attributeName, byte value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified byte value for a named attribute
 void setBeliefAttributeByte(IConcept lhsConcept, java.lang.String attributeName, int index, byte value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified byte value for a named collection attribute at an int index
 void setBeliefAttributeByte(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, byte value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified byte value for a named collection attribute at a String key
 void setBeliefAttributeChar(IConcept lhsConcept, java.lang.String attributeName, char value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified char value for a named attribute
 void setBeliefAttributeChar(IConcept lhsConcept, java.lang.String attributeName, int index, char value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified char value for a named collection attribute at an int index
 void setBeliefAttributeChar(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, char value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified char value for a named collection attribute at a String key
 void setBeliefAttributeConcept(IConcept lhsConcept, java.lang.String attributeName, IConcept value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified IConcept value for a named attribute
 void setBeliefAttributeConcept(IConcept lhsConcept, java.lang.String attributeName, int index, IConcept value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified IConcept value for a named collection attribute at an int index
 void setBeliefAttributeConcept(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IConcept value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified IConcept value for a named collection attribute at a String key
 void setBeliefAttributeDouble(IConcept lhsConcept, java.lang.String attributeName, double value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified double value for a named attribute
 void setBeliefAttributeDouble(IConcept lhsConcept, java.lang.String attributeName, int index, double value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified double value for a named collection attribute at an int index
 void setBeliefAttributeDouble(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, double value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified double value for a named collection attribute at a String key
 void setBeliefAttributeFloat(IConcept lhsConcept, java.lang.String attributeName, float value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified float value for a named attribute
 void setBeliefAttributeFloat(IConcept lhsConcept, java.lang.String attributeName, int index, float value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified float value for a named collection attribute at an int index
 void setBeliefAttributeFloat(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, float value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified float value for a named collection attribute at a String key
 void setBeliefAttributeInt(IConcept lhsConcept, java.lang.String attributeName, int value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified int value for a named attribute
 void setBeliefAttributeInt(IConcept lhsConcept, java.lang.String attributeName, int index, int value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified int value for a named collection attribute at an int index
 void setBeliefAttributeInt(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, int value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified int value for a named collection attribute at a String key
 void setBeliefAttributeJava(IConcept lhsConcept, java.lang.String attributeName, int index, java.lang.Object value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Object value for a named collection attribute at an int index
 void setBeliefAttributeJava(IConcept lhsConcept, java.lang.String attributeName, int index, java.io.Serializable value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Serializable value for a named collection attribute at an int index
 void setBeliefAttributeJava(IConcept lhsConcept, java.lang.String attributeName, java.lang.Object value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Object value for a named attribute
 void setBeliefAttributeJava(IConcept lhsConcept, java.lang.String attributeName, java.io.Serializable value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Serializable value for a named attribute
 void setBeliefAttributeJava(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, java.lang.Object value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Object value for a named collection attribute at a String key
 void setBeliefAttributeJava(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, java.io.Serializable value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Serializable value for a named collection attribute at a String key
 void setBeliefAttributeLong(IConcept lhsConcept, java.lang.String attributeName, int index, long value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified long value for a named collection attribute at an int index
 void setBeliefAttributeLong(IConcept lhsConcept, java.lang.String attributeName, long value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified long value for a named attribute
 void setBeliefAttributeLong(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, long value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified long value for a named collection attribute at a String key
 void setBeliefAttributeShort(IConcept lhsConcept, java.lang.String attributeName, int index, short value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified short value for a named collection attribute at an int index
 void setBeliefAttributeShort(IConcept lhsConcept, java.lang.String attributeName, short value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified short value for a named attribute
 void setBeliefAttributeShort(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, short value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified short value for a named collection attribute at a String key
 void setBeliefAttributeString(IConcept lhsConcept, java.lang.String attributeName, int index, java.lang.String value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified string value for a named collection attribute at an int index
 void setBeliefAttributeString(IConcept lhsConcept, java.lang.String attributeName, java.lang.String value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified string value for a named attribute
 void setBeliefAttributeString(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, java.lang.String value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified string value for a named collection attribute at a String key
 void setBeliefAttributeSymbol(IConcept lhsConcept, java.lang.String attributeName, int index, java.lang.String value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified symbol value for a named collection attribute at an int index
 void setBeliefAttributeSymbol(IConcept lhsConcept, java.lang.String attributeName, java.lang.String value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified symbol value for a named attribute
 void setBeliefAttributeSymbol(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, java.lang.String value, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has a specified symbol value for a named collection attribute at a String key
 void setBeliefAttributeUnknown(IConcept lhsConcept, java.lang.String attributeName, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has the unknown value for a named attribute
 void setBeliefAttributeUnknown(IConcept lhsConcept, java.lang.String attributeName, int index, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has the unknown value for a named collection attribute at an int index
 void setBeliefAttributeUnknown(IConcept lhsConcept, java.lang.String attributeName, java.lang.String key, IContext ctx)
          Creates and asserts a new belief in the belief state representing that an IConcept has the unknown value for a named collection attribute at a String key
 void setBeliefRelationUnknown(IConcept lhsConcept, java.lang.String relationName, IContext ctx)
          Removes any existing concepts as values of a named relation for a concept by giving the relation a value of unknown.
 
Methods inherited from interface gov.nasa.arc.brahms.vm.api.common.IActiveConcept
hasThoughtframes, hasWorkframes
 
Methods inherited from interface gov.nasa.arc.brahms.vm.api.common.IConcept
getAttribute, getAttributes, getRelation, getRelations, isLocal
 
Methods inherited from interface gov.nasa.arc.brahms.vm.api.common.IType
getName, getType
 

Method Detail

registerForMonitoring

void registerForMonitoring()
Registers this agent with the agent monitor to have this agent monitored for unexpected termination and failures.


deregisterForMonitoring

void deregisterForMonitoring()
Deregisters this agent with the agent monitor to no longer have this agent monitored for unexpected termination and failures.


acquireMemoryReference

boolean acquireMemoryReference(IContext ctx)
                               throws ExternalException
Has the calling agent acquire a reference to this IActiveInstance indicating that it wishes to use this reference and to ensure that this IActiveInstance will not get deleted.

Note that multiple calls to this method will result in only one reference to be maintained for the calling agent.

This method should only be used by external agents.

Parameters:
ctx - the IContext for the acquisition providing information about the agent acquiring the reference
Returns:
boolean true if the reference could be acquired, false if this IActiveInstance is not a memory managed element.
Throws:
ExternalException - if IActiveInstance is a memory managed element and was already deleted or if an internal error occurs.

releaseMemoryReference

void releaseMemoryReference(IContext ctx)
                            throws ExternalException
Has the calling agent release a reference to this IActiveInstance indicating that it no longer wishes to use this reference and to allow for this IActiveInstance to be deleted.

Note that multiple calls to this method will result in the removal of the single reference maintained for the calling agent, once removed the operation has no effect on subsequent calls.

This method should only be used by external agents.

Parameters:
ctx - the IContext for the acquisition providing information about the agent acquiring the reference
Throws:
ExternalException - if an internal error occurs.

assertBelief

void assertBelief(IBelief belief,
                  IContext ctx)
                  throws ExternalException
Schedules the assertion of the specified belief to the active instance's belief set. The assertion of the belief is scheduled on the active instance's discrete event queue for processing by the active instance. The belief will not immediately be asserted in the belief set.

Note: If multiple beliefs are to be asserted to a remote agent use the assert method to which multiple beliefs can be passed to reduce communication overhead. The beliefs will be bundled in one communication package in that case, while with this method for each belief a separate communication package is created.

Parameters:
belief - the IBelief to be asserted
ctx - the IContext for the action
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure

assertBeliefs

void assertBeliefs(IBelief[] beliefs,
                   IContext ctx)
                   throws ExternalException
Schedules the assertion of the specified beliefs to the active instance's belief set. The assertion of the beliefs is scheduled on the active instance's discrete event queue for processing by the active instance. The belief will not immediately be asserted in the belief set.

Note: If multiple beliefs are to be transmitted to a remote agent this method should be used to reduce communication overhead. The beliefs will be bundled in one communication package.

Parameters:
beliefs - the set of IBelief to be asserted
ctx - the IContext for the action
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure

retractBelief

void retractBelief(IBelief belief,
                   IContext ctx)
                   throws ExternalException
Schedules the retraction of the specified belief from the active instance's belief set. The retraction of the belief is scheduled on the active instance's discrete event queue for processing by the active instance. The belief will not immediately be retracted from the belief set.

Parameters:
belief - the IBelief to be asserted
ctx - the IContext for the action
Throws:
ExternalException - if an internal error occurs

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  int value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side integer value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  char value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side character value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  byte value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side byte value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  short value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side short value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  long value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side long value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  float value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side float value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  double value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side double value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  boolean value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side boolean value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  java.lang.String value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side string or symbol value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  IConcept value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side IConcept value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  java.io.Serializable value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side Java Serializable value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  java.lang.Object value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side Java Object value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int relop,
                  IUnknown value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
relop - the relational operator in the requested belief
value - the right hand side 'unknown' value in the requested fact
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS, IUnknown.UNKNOWN

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  int value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side integer value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  int value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side integer value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  char value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side character value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  char value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side character value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  byte value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side byte value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  byte value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side byte value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  short value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side short value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  short value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side short value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  long value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side long value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  long value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side long value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  float value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side float value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  float value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side float value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  double value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side double value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  double value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side double value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  boolean value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side boolean value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  boolean value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side boolean value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  java.lang.String value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side string or symbol value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  java.lang.String value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side string or symbol value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  IConcept value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side IConcept value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  IConcept value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side IConcept value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  java.io.Serializable value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side Java Serializable value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  java.lang.Object value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side Java Object value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  java.io.Serializable value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side Java Serializable value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  java.lang.Object value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side Java Object value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  int lhsCollectionIndex,
                  int relop,
                  IUnknown value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side 'unknown' value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS, IUnknown.UNKNOWN

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IAttribute lhsAttribute,
                  java.lang.String lhsCollectionIndex,
                  int relop,
                  IUnknown value,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
value - the right hand side 'unknown' value in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS, IUnknown.UNKNOWN

getBeliefForIndex

IBelief getBeliefForIndex(IConcept lhsConcept,
                          IAttribute lhsAttribute,
                          int lhsCollectionIndex,
                          int relop,
                          IContext ctx)
                          throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the integer index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS, IUnknown.UNKNOWN

getBeliefForIndex

IBelief getBeliefForIndex(IConcept lhsConcept,
                          IAttribute lhsAttribute,
                          java.lang.String lhsCollectionIndex,
                          int relop,
                          IContext ctx)
                          throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
lhsAttribute - the left hand side IAttribute in the requested belief
lhsCollectionIndex - the String index/key if the attribute's type is a collection
relop - the relational operator in the requested belief
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS, IUnknown.UNKNOWN

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IRelation relation,
                  IConcept rhsConcept,
                  int truthValue,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
relation - the IRelation in the requested belief
rhsConcept - the right hand side IConcept in the requested belief
truthValue - the truth value in the requested belief (TRUE, FALSE, UNKNOWN)
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, ITruthValue.TRUE, ITruthValue.FALSE, ITruthValue.UNKNOWN

getBelief

IBelief getBelief(IConcept lhsConcept,
                  IRelation relation,
                  IUnknown rhsConcept,
                  int truthValue,
                  IContext ctx)
                  throws ExternalException
Find the belief using the specified parameters and return the belief if found, null if the belief was not found.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief
relation - the IRelation in the requested belief
rhsConcept - the right hand side 'unknown' value in the requested fact
truthValue - the truth value in the requested belief (TRUE, FALSE, UNKNOWN)
ctx - the IContext for the action
Returns:
IBelief if the matching belief is found, null otherwise
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, ITruthValue.TRUE, ITruthValue.FALSE, ITruthValue.UNKNOWN, ITruthValue.UNKNOWN

getBeliefs

java.util.Enumeration getBeliefs(IContext ctx)
                                 throws ExternalException
Returns the active instance's belief set.

Parameters:
ctx - the IContext for the action
Returns:
Enumeration an enumeration of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException

getBeliefs

java.util.Enumeration getBeliefs(IAttribute lhsAttribute,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified attribute on their left hand side regardless of their lhs concept, relational operator or value.

Parameters:
lhsAttribute - the left hand side IAttribute in the requested belief(s)
ctx - the IContext for the action
Returns:
Enumeration an enumeration of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side regardless of their relational operator or value.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side and that use the specified relational operator.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 int value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the integer value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 char value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the character value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 byte value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the byte value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 short value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the short value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 long value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the long value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 float value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the float value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 double value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the double value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 boolean value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the boolean value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 java.lang.String value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the String or symbol value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 IConcept value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the IConcept value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 java.io.Serializable value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the Java Serializable value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 java.lang.Object value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the Java Object value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IAttribute lhsAttribute,
                                 int relop,
                                 IUnknown value,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified concept and attribute on their left hand side, that use the specified relational operator and have the specified rhs value. Multiple beliefs can only be returned if the attribute is of a collection type and the value is matched for multiple different indexes/keys.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
lhsAttribute - the left hand side IAttribute in the requested belief(s)
relop - the relational operator in the requested belief(s)
value - the IUnknown value to match
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IRelationalOperator.EQUALS, IRelationalOperator.NOT_EQUALS

getBeliefs

java.util.Enumeration getBeliefs(IRelation relation,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified relation regardless of their left and right hand side concept.

Parameters:
relation - the IRelation in the requested belief(s)
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IRelation relation,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified left hand side concept and relation regardless of their right hand side concept.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
relation - the IRelation in the requested belief(s)
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException

getBeliefs

java.util.Enumeration getBeliefs(IConcept lhsConcept,
                                 IRelation relation,
                                 int truthvalue,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified left hand side concept, relation and truth value regardless of their right hand side concept.

Parameters:
lhsConcept - the left hand side IConcept in the requested belief(s)
relation - the IRelation in the requested belief(s)
truthvalue - the truth value in the requested belief(s) (TRUE, FALSE, UNKNOWN)
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, ITruthValue.TRUE, ITruthValue.FALSE, ITruthValue.UNKNOWN

getBeliefs

java.util.Enumeration getBeliefs(IRelation relation,
                                 IConcept rhsConcept,
                                 int truthvalue,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified relation and right hand side concept, and truth value regardless of their left hand side concept.

Parameters:
relation - the IRelation in the requested belief(s)
rhsConcept - the right hand side IConcept in the requested belief(s)
truthvalue - the truth value in the requested belief(s) (TRUE, FALSE, UNKNOWN)
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, ITruthValue.TRUE, ITruthValue.FALSE, ITruthValue.UNKNOWN

getBeliefs

java.util.Enumeration getBeliefs(IRelation relation,
                                 IUnknown rhsConcept,
                                 int truthvalue,
                                 IContext ctx)
                                 throws ExternalException
Returns a list of all the beliefs that have the specified relation, as right hand side 'unknown', and the specified truth value regardless of their left hand side concept.

Parameters:
relation - the IRelation in the requested belief(s)
rhsConcept - the right hand side 'unknown' value in the requested fact(s)
truthvalue - the truth value in the requested belief(s) (TRUE, FALSE, UNKNOWN)
ctx - the IContext for the action
Returns:
Enumeration a list of IBelief's
Throws:
ExternalException - ExternalException if an internal error occurs, in case of a communication failure the linked exception will be one of ServiceException, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, or SecurityFailure
See Also:
ServiceException, SecurityFailure, NoSuchActorException, ActorNotActiveException, NotLocatableException, TransportFailure, MessageNotRepliedToException, IUnknown.UNKNOWN, ITruthValue.TRUE, ITruthValue.FALSE, ITruthValue.UNKNOWN

getBeliefAttributeInt

int getBeliefAttributeInt(IConcept lhsConcept,
                          java.lang.String attributeName,
                          IContext ctx)
                          throws UnknownValueException,
                                 InvalidTypeException,
                                 ExternalException
Retrieves an int value for an attribute of a concept from the active instance's belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
int the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the value of the attribute is not of type int
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeInt

int getBeliefAttributeInt(IConcept lhsConcept,
                          java.lang.String attributeName,
                          int index,
                          IContext ctx)
                          throws UnknownValueException,
                                 InvalidTypeException,
                                 ExternalException
Retrieves an int value for a collection attribute of a concept at a given integer index from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
int the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type int
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeInt

int getBeliefAttributeInt(IConcept lhsConcept,
                          java.lang.String attributeName,
                          java.lang.String key,
                          IContext ctx)
                          throws UnknownValueException,
                                 InvalidTypeException,
                                 ExternalException
Retrieves an int value for a collection attribute of a concept at a given String key from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
int the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type int
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeChar

char getBeliefAttributeChar(IConcept lhsConcept,
                            java.lang.String attributeName,
                            IContext ctx)
                            throws UnknownValueException,
                                   InvalidTypeException,
                                   ExternalException
Retrieves a char value for an attribute of a concept from the active instance's belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
char the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the value of the attribute is not of type char
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeChar

char getBeliefAttributeChar(IConcept lhsConcept,
                            java.lang.String attributeName,
                            int index,
                            IContext ctx)
                            throws UnknownValueException,
                                   InvalidTypeException,
                                   ExternalException
Retrieves a char value for a collection attribute of a concept at a given integer index from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
char the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type char
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeChar

char getBeliefAttributeChar(IConcept lhsConcept,
                            java.lang.String attributeName,
                            java.lang.String key,
                            IContext ctx)
                            throws UnknownValueException,
                                   InvalidTypeException,
                                   ExternalException
Retrieves a char value for a collection attribute of a concept at a given String key from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
char the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type char
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeByte

byte getBeliefAttributeByte(IConcept lhsConcept,
                            java.lang.String attributeName,
                            IContext ctx)
                            throws UnknownValueException,
                                   InvalidTypeException,
                                   ExternalException
Retrieves a byte value for an attribute of a concept from the active instance's belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
byte the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the value of the attribute is not of type byte
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeByte

byte getBeliefAttributeByte(IConcept lhsConcept,
                            java.lang.String attributeName,
                            int index,
                            IContext ctx)
                            throws UnknownValueException,
                                   InvalidTypeException,
                                   ExternalException
Retrieves a byte value for a collection attribute of a concept at a given integer index from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
byte the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type byte
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeByte

byte getBeliefAttributeByte(IConcept lhsConcept,
                            java.lang.String attributeName,
                            java.lang.String key,
                            IContext ctx)
                            throws UnknownValueException,
                                   InvalidTypeException,
                                   ExternalException
Retrieves a byte value for a collection attribute of a concept at a given String key from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
byte the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type byte
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeShort

short getBeliefAttributeShort(IConcept lhsConcept,
                              java.lang.String attributeName,
                              IContext ctx)
                              throws UnknownValueException,
                                     InvalidTypeException,
                                     ExternalException
Retrieves a short value for an attribute of a concept from the active instance's belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
short the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the value of the attribute is not of type short
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeShort

short getBeliefAttributeShort(IConcept lhsConcept,
                              java.lang.String attributeName,
                              int index,
                              IContext ctx)
                              throws UnknownValueException,
                                     InvalidTypeException,
                                     ExternalException
Retrieves a short value for a collection attribute of a concept at a given integer index from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
short the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type short
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeShort

short getBeliefAttributeShort(IConcept lhsConcept,
                              java.lang.String attributeName,
                              java.lang.String key,
                              IContext ctx)
                              throws UnknownValueException,
                                     InvalidTypeException,
                                     ExternalException
Retrieves a short value for a collection attribute of a concept at a given String key from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
short the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type short
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeLong

long getBeliefAttributeLong(IConcept lhsConcept,
                            java.lang.String attributeName,
                            IContext ctx)
                            throws UnknownValueException,
                                   InvalidTypeException,
                                   ExternalException
Retrieves a long value for an attribute of a concept from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
long the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the value of the attribute is not of type long
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeLong

long getBeliefAttributeLong(IConcept lhsConcept,
                            java.lang.String attributeName,
                            int index,
                            IContext ctx)
                            throws UnknownValueException,
                                   InvalidTypeException,
                                   ExternalException
Retrieves a long value for a collection attribute of a concept at a given integer index from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
long the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type long
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeLong

long getBeliefAttributeLong(IConcept lhsConcept,
                            java.lang.String attributeName,
                            java.lang.String key,
                            IContext ctx)
                            throws UnknownValueException,
                                   InvalidTypeException,
                                   ExternalException
Retrieves a long value for a collection attribute of a concept at a given String key from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
long the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type long
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeFloat

float getBeliefAttributeFloat(IConcept lhsConcept,
                              java.lang.String attributeName,
                              IContext ctx)
                              throws UnknownValueException,
                                     InvalidTypeException,
                                     ExternalException
Retrieves a float value for an attribute of a concept from the active instance's belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
float the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the value of the attribute is not of type float
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeFloat

float getBeliefAttributeFloat(IConcept lhsConcept,
                              java.lang.String attributeName,
                              int index,
                              IContext ctx)
                              throws UnknownValueException,
                                     InvalidTypeException,
                                     ExternalException
Retrieves a float value for a collection attribute of a concept at a given integer index from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
float the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type float
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeFloat

float getBeliefAttributeFloat(IConcept lhsConcept,
                              java.lang.String attributeName,
                              java.lang.String key,
                              IContext ctx)
                              throws UnknownValueException,
                                     InvalidTypeException,
                                     ExternalException
Retrieves a float value for a collection attribute of a concept at a given String key from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
float the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type float
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeDouble

double getBeliefAttributeDouble(IConcept lhsConcept,
                                java.lang.String attributeName,
                                IContext ctx)
                                throws UnknownValueException,
                                       InvalidTypeException,
                                       ExternalException
Retrieves a double value for an attribute of a concept from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
double the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the value of the attribute is not of type double
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeDouble

double getBeliefAttributeDouble(IConcept lhsConcept,
                                java.lang.String attributeName,
                                int index,
                                IContext ctx)
                                throws UnknownValueException,
                                       InvalidTypeException,
                                       ExternalException
Retrieves a double value for a collection attribute of a concept at a given integer index from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
double the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type double
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeDouble

double getBeliefAttributeDouble(IConcept lhsConcept,
                                java.lang.String attributeName,
                                java.lang.String key,
                                IContext ctx)
                                throws UnknownValueException,
                                       InvalidTypeException,
                                       ExternalException
Retrieves a double value for a collection attribute of a concept at a given String key from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
double the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type double
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeBoolean

boolean getBeliefAttributeBoolean(IConcept lhsConcept,
                                  java.lang.String attributeName,
                                  IContext ctx)
                                  throws UnknownValueException,
                                         InvalidTypeException,
                                         ExternalException
Retrieves a boolean value for an attribute of a concept from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
boolean the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the value of the attribute is not of type boolean
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeBoolean

boolean getBeliefAttributeBoolean(IConcept lhsConcept,
                                  java.lang.String attributeName,
                                  int index,
                                  IContext ctx)
                                  throws UnknownValueException,
                                         InvalidTypeException,
                                         ExternalException
Retrieves a boolean value for a collection attribute of a concept at a given integer index from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
boolean the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type boolean
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeBoolean

boolean getBeliefAttributeBoolean(IConcept lhsConcept,
                                  java.lang.String attributeName,
                                  java.lang.String key,
                                  IContext ctx)
                                  throws UnknownValueException,
                                         InvalidTypeException,
                                         ExternalException
Retrieves a boolean value for a collection attribute of a concept at a given String key from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
boolean the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type boolean
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeString

java.lang.String getBeliefAttributeString(IConcept lhsConcept,
                                          java.lang.String attributeName,
                                          IContext ctx)
                                          throws UnknownValueException,
                                                 InvalidTypeException,
                                                 ExternalException
Retrieves a String value for an attribute of a concept from a belief in the belief state The attribute's Brahms type may be either string or symbol.

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
String the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the value of the attribute is not a string
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeString

java.lang.String getBeliefAttributeString(IConcept lhsConcept,
                                          java.lang.String attributeName,
                                          int index,
                                          IContext ctx)
                                          throws UnknownValueException,
                                                 InvalidTypeException,
                                                 ExternalException
Retrieves a String value for a collection attribute of a concept at a given integer index from a belief in the belief state The Brahms type of the value may be either string or symbol.

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
String the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not a string
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeString

java.lang.String getBeliefAttributeString(IConcept lhsConcept,
                                          java.lang.String attributeName,
                                          java.lang.String key,
                                          IContext ctx)
                                          throws UnknownValueException,
                                                 InvalidTypeException,
                                                 ExternalException
Retrieves a String value for a collection attribute of a concept at a given String key from a belief in the belief state The Brahms type of the value may be either string or symbol.

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
String the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not a string
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeJava

java.io.Serializable getBeliefAttributeJava(IConcept lhsConcept,
                                            java.lang.String attributeName,
                                            IContext ctx)
                                            throws UnknownValueException,
                                                   InvalidTypeException,
                                                   ExternalException
Retrieves a Serializable value for an attribute of a concept from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
Serializable the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the value of the attribute is not of type Serializable
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeJava

java.io.Serializable getBeliefAttributeJava(IConcept lhsConcept,
                                            java.lang.String attributeName,
                                            int index,
                                            IContext ctx)
                                            throws UnknownValueException,
                                                   InvalidTypeException,
                                                   ExternalException
Retrieves a Serializable value for a collection attribute of a concept at a given integer index from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
Serializable the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type Serializable
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeJava

java.io.Serializable getBeliefAttributeJava(IConcept lhsConcept,
                                            java.lang.String attributeName,
                                            java.lang.String key,
                                            IContext ctx)
                                            throws UnknownValueException,
                                                   InvalidTypeException,
                                                   ExternalException
Retrieves a Serializable value for a collection attribute of a concept at a given String key from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
Serializable the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not of type Serializable
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeConcept

IConcept getBeliefAttributeConcept(IConcept lhsConcept,
                                   java.lang.String attributeName,
                                   IContext ctx)
                                   throws UnknownValueException,
                                          InvalidTypeException,
                                          ExternalException
Retrieves an IConcept value for an attribute of a concept from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
IConcept the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the value of the attribute is not a concept
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeConcept

IConcept getBeliefAttributeConcept(IConcept lhsConcept,
                                   java.lang.String attributeName,
                                   int index,
                                   IContext ctx)
                                   throws UnknownValueException,
                                          InvalidTypeException,
                                          ExternalException
Retrieves an IConcept value for a collection attribute of a concept at a given integer index from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
IConcept the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not a concept
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeConcept

IConcept getBeliefAttributeConcept(IConcept lhsConcept,
                                   java.lang.String attributeName,
                                   java.lang.String key,
                                   IContext ctx)
                                   throws UnknownValueException,
                                          InvalidTypeException,
                                          ExternalException
Retrieves an IConcept value for a collection attribute of a concept at a given String key from a belief in the belief state

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
IConcept the value of the attribute
Throws:
UnknownValueException - if the value of the attribute is missing or unknown
InvalidTypeException - if the attribute does not have a collection type or the value of the attribute is not a concept
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeMap

java.util.Map<java.lang.Object,java.lang.Object> getBeliefAttributeMap(IConcept lhsConcept,
                                                                       java.lang.String attributeName,
                                                                       boolean includeUnknown,
                                                                       IContext ctx)
                                                                       throws InvalidTypeException,
                                                                              ExternalException
Returns a Map representing the values for a map attribute of a concept from beliefs in the belief state Entries with values of unknown are included in the returned Map if the includeUnknown parameter is true. An empty Map will be returned if the value of the map attribute is Unknown.

Parameters:
lhsConcept - an IConcept whose map attribute values are to be retrieved
attributeName - the String name of the map attribute whose values are to be retrieved
includeUnknown - true if unknown values should be included in the map entries
ctx - the IContext for retrieving the value
Returns:
Map a map from the index/keys of the map attribute to their values
Throws:
InvalidTypeException - if the attribute is not a map attribute
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeSortedMap

java.util.SortedMap<java.lang.Object,java.lang.Object> getBeliefAttributeSortedMap(IConcept lhsConcept,
                                                                                   java.lang.String attributeName,
                                                                                   boolean includeUnknown,
                                                                                   IContext ctx)
                                                                                   throws InvalidTypeException,
                                                                                          ExternalException
Returns a sorted Map representing the values for a map attribute of a concept from beliefs in the belief state Entries with values of unknown are included in the returned Map if the includeUnknown parameter is true. An empty Map will be returned if the value of the map attribute is Unknown.

Parameters:
lhsConcept - an IConcept whose map attribute values are to be retrieved
attributeName - the String name of the map attribute whose values are to be retrieved
includeUnknown - true if unknown values should be included in the map entries
ctx - the IContext for retrieving the value
Returns:
SortedMap a sorted map from the index/keys of the map attribute to their values
Throws:
InvalidTypeException - if the attribute is not a map attribute
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeValue

java.lang.Object getBeliefAttributeValue(IConcept lhsConcept,
                                         java.lang.String attributeName,
                                         IContext ctx)
                                         throws ExternalException
Retrieves the value for an attribute of a concept from a belief in the belief state Returns null if there is no corresponding belief in the belief state. Returns IUnknown.UNKNOWN if the value of the attribute is the unknown value.

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
ctx - the IContext for retrieving the value
Returns:
Object the value of the attribute
Throws:
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeValue

java.lang.Object getBeliefAttributeValue(IConcept lhsConcept,
                                         java.lang.String attributeName,
                                         int index,
                                         IContext ctx)
                                         throws InvalidTypeException,
                                                ExternalException
Retrieves the value for a collection attribute of a concept at a given integer index from a belief in the belief state Returns null if there is no corresponding belief in the belief state. Returns IUnknown.UNKNOWN if the value of the attribute for the index is the unknown value.

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
index - the integer index to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
Object the value of the attribute
Throws:
InvalidTypeException - if the attribute is not a collection attribute
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefAttributeValue

java.lang.Object getBeliefAttributeValue(IConcept lhsConcept,
                                         java.lang.String attributeName,
                                         java.lang.String key,
                                         IContext ctx)
                                         throws InvalidTypeException,
                                                ExternalException
Retrieves the value for a collection attribute of a concept at a given String key from a belief in the belief state Returns null if there is no corresponding belief in the belief state. Returns IUnknown.UNKNOWN if the value of the attribute for the key is the unknown value.

Parameters:
lhsConcept - an IConcept whose attribute value is to be retrieved
attributeName - the String name of the attribute whose value is to be retrieved
key - the String key to be looked up in the map
ctx - the IContext for retrieving the value
Returns:
Object the value of the attribute
Throws:
InvalidTypeException - if the attribute is not a collection attribute
ExternalException - if the concept does not have the named attribute or an internal error occurs

hasBeliefAttributeAnyValue

boolean hasBeliefAttributeAnyValue(IConcept lhsConcept,
                                   java.lang.String attributeName,
                                   boolean includeUnknown,
                                   IContext ctx)
                                   throws ExternalException
Tests whether a concept has any value for a named attribute based on the beliefs in the belief state. The includeUnknown parameter controls whether the 'unknown' value counts as a value or only 'definite' values are considered.

Parameters:
lhsConcept - an IConcept whose attribute value is to be checked
attributeName - the String name of the attribute whose value is to be checked
includeUnknown - true if the unknown value is counted, else false
ctx - the IContext used for the retrieval
Returns:
boolean true if the concept has the 'unknown' value for the attribute, else false
Throws:
ExternalException - if the concept does not have the named attribute or an internal error occurs

hasBeliefAttributeAnyValue

boolean hasBeliefAttributeAnyValue(IConcept lhsConcept,
                                   java.lang.String attributeName,
                                   int index,
                                   boolean includeUnknown,
                                   IContext ctx)
                                   throws InvalidTypeException,
                                          ExternalException
Tests whether a concept has any value for a named collection attribute at a given integer index based on the beliefs in the belief state. The includeUnknown parameter controls whether the 'unknown' value counts as a value or only 'definite' values are considered.

Parameters:
lhsConcept - an IConcept whose attribute value is to be checked
attributeName - the String name of the attribute whose value is to be checked
index - the integer index to be looked up in the map
includeUnknown - true if the unknown value is counted, else false
ctx - the IContext used for the retrieval
Returns:
boolean true if the concept has any value for the attribute and index, else false
Throws:
InvalidTypeException - if the attribute is not a collection attribute
ExternalException - if the concept does not have the named attribute or an internal error occurs

hasBeliefAttributeAnyValue

boolean hasBeliefAttributeAnyValue(IConcept lhsConcept,
                                   java.lang.String attributeName,
                                   java.lang.String key,
                                   boolean includeUnknown,
                                   IContext ctx)
                                   throws InvalidTypeException,
                                          ExternalException
Tests whether a concept has any value for a named collection attribute at a given String key based on the beliefs in the belief state. The includeUnknown parameter controls whether the 'unknown' value counts as a value or only 'definite' values are considered.

Parameters:
lhsConcept - an IConcept whose attribute value is to be checked
attributeName - the String name of the attribute whose value is to be checked
key - the String key to be looked up in the map
includeUnknown - true if the unknown value is counted, else false
ctx - the IContext used for the retrieval
Returns:
boolean true if the concept has any value for the attribute and index, else false
Throws:
InvalidTypeException - if the attribute is not a collection attribute
ExternalException - if the concept does not have the named attribute or an internal error occurs

hasBeliefAttributeValue

boolean hasBeliefAttributeValue(IConcept lhsConcept,
                                java.lang.String attributeName,
                                java.lang.Object value,
                                IContext ctx)
                                throws ExternalException
Tests whether a concept has a specified value for a named attribute based on the beliefs in the belief state.

Parameters:
lhsConcept - an IConcept whose attribute value is to be checked
attributeName - the String name of the attribute whose value is to be checked
value - an Object to be compared for equality to the current value of the attribute, if any
ctx - the IContext for checking the attribute
Returns:
boolean true if the concept has the specified value for the attribute, else false
Throws:
ExternalException - if the concept does not have the named attribute or an internal error occurs

hasBeliefAttributeValue

boolean hasBeliefAttributeValue(IConcept lhsConcept,
                                java.lang.String attributeName,
                                int index,
                                java.lang.Object value,
                                IContext ctx)
                                throws InvalidTypeException,
                                       ExternalException
Tests whether a concept has a specified value for a named attribute based on the beliefs in the belief state.

Parameters:
lhsConcept - an IConcept whose attribute value is to be checked
attributeName - the String name of the attribute whose value is to be checked
index - the integer index to be looked up in the map
value - an Object to be compared for equality to the current value of the attribute for the index, if any
ctx - the IContext for checking the attribute
Returns:
boolean true if the concept has a known value for the attribute and index, else false
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

hasBeliefAttributeValue

boolean hasBeliefAttributeValue(IConcept lhsConcept,
                                java.lang.String attributeName,
                                java.lang.String key,
                                java.lang.Object value,
                                IContext ctx)
                                throws InvalidTypeException,
                                       ExternalException
Tests whether a concept has a specified value for a named attribute based on the beliefs in the belief state.

Parameters:
lhsConcept - an IConcept whose attribute value is to be checked
attributeName - the String name of the attribute whose value is to be checked
key - the String key to be looked up in the map
value - an Object to be compared for equality to the current value of the attribute for the key, if any
ctx - the IContext for checking the attribute
Returns:
boolean true if the concept has a known value for the attribute and key, else false
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeInt

void setBeliefAttributeInt(IConcept lhsConcept,
                           java.lang.String attributeName,
                           int value,
                           IContext ctx)
                           throws InvalidTypeException,
                                  ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified int value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new int value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeInt

void setBeliefAttributeInt(IConcept lhsConcept,
                           java.lang.String attributeName,
                           int index,
                           int value,
                           IContext ctx)
                           throws InvalidTypeException,
                                  ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified int value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new int value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeInt

void setBeliefAttributeInt(IConcept lhsConcept,
                           java.lang.String attributeName,
                           java.lang.String key,
                           int value,
                           IContext ctx)
                           throws InvalidTypeException,
                                  ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified int value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new int value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeChar

void setBeliefAttributeChar(IConcept lhsConcept,
                            java.lang.String attributeName,
                            char value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified char value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new char value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeChar

void setBeliefAttributeChar(IConcept lhsConcept,
                            java.lang.String attributeName,
                            int index,
                            char value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified char value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new char value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeChar

void setBeliefAttributeChar(IConcept lhsConcept,
                            java.lang.String attributeName,
                            java.lang.String key,
                            char value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified char value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new char value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeByte

void setBeliefAttributeByte(IConcept lhsConcept,
                            java.lang.String attributeName,
                            byte value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified byte value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new byte value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeByte

void setBeliefAttributeByte(IConcept lhsConcept,
                            java.lang.String attributeName,
                            int index,
                            byte value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified byte value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new byte value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeByte

void setBeliefAttributeByte(IConcept lhsConcept,
                            java.lang.String attributeName,
                            java.lang.String key,
                            byte value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified byte value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new byte value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeShort

void setBeliefAttributeShort(IConcept lhsConcept,
                             java.lang.String attributeName,
                             short value,
                             IContext ctx)
                             throws InvalidTypeException,
                                    ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified short value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new short value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeShort

void setBeliefAttributeShort(IConcept lhsConcept,
                             java.lang.String attributeName,
                             int index,
                             short value,
                             IContext ctx)
                             throws InvalidTypeException,
                                    ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified short value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new short value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeShort

void setBeliefAttributeShort(IConcept lhsConcept,
                             java.lang.String attributeName,
                             java.lang.String key,
                             short value,
                             IContext ctx)
                             throws InvalidTypeException,
                                    ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified short value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new short value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeLong

void setBeliefAttributeLong(IConcept lhsConcept,
                            java.lang.String attributeName,
                            long value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified long value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new long value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeLong

void setBeliefAttributeLong(IConcept lhsConcept,
                            java.lang.String attributeName,
                            int index,
                            long value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified long value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new long value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeLong

void setBeliefAttributeLong(IConcept lhsConcept,
                            java.lang.String attributeName,
                            java.lang.String key,
                            long value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified long value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new long value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeFloat

void setBeliefAttributeFloat(IConcept lhsConcept,
                             java.lang.String attributeName,
                             float value,
                             IContext ctx)
                             throws InvalidTypeException,
                                    ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified float value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new float value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeFloat

void setBeliefAttributeFloat(IConcept lhsConcept,
                             java.lang.String attributeName,
                             int index,
                             float value,
                             IContext ctx)
                             throws InvalidTypeException,
                                    ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified float value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new float value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeFloat

void setBeliefAttributeFloat(IConcept lhsConcept,
                             java.lang.String attributeName,
                             java.lang.String key,
                             float value,
                             IContext ctx)
                             throws InvalidTypeException,
                                    ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified float value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new float value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeDouble

void setBeliefAttributeDouble(IConcept lhsConcept,
                              java.lang.String attributeName,
                              double value,
                              IContext ctx)
                              throws InvalidTypeException,
                                     ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified double value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new double value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeDouble

void setBeliefAttributeDouble(IConcept lhsConcept,
                              java.lang.String attributeName,
                              int index,
                              double value,
                              IContext ctx)
                              throws InvalidTypeException,
                                     ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified double value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new double value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeDouble

void setBeliefAttributeDouble(IConcept lhsConcept,
                              java.lang.String attributeName,
                              java.lang.String key,
                              double value,
                              IContext ctx)
                              throws InvalidTypeException,
                                     ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified double value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new double value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeBoolean

void setBeliefAttributeBoolean(IConcept lhsConcept,
                               java.lang.String attributeName,
                               boolean value,
                               IContext ctx)
                               throws InvalidTypeException,
                                      ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified boolean value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new boolean value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeBoolean

void setBeliefAttributeBoolean(IConcept lhsConcept,
                               java.lang.String attributeName,
                               int index,
                               boolean value,
                               IContext ctx)
                               throws InvalidTypeException,
                                      ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified boolean value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new boolean value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeBoolean

void setBeliefAttributeBoolean(IConcept lhsConcept,
                               java.lang.String attributeName,
                               java.lang.String key,
                               boolean value,
                               IContext ctx)
                               throws InvalidTypeException,
                                      ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified boolean value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new boolean value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeString

void setBeliefAttributeString(IConcept lhsConcept,
                              java.lang.String attributeName,
                              java.lang.String value,
                              IContext ctx)
                              throws InvalidTypeException,
                                     ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified string value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeString

void setBeliefAttributeString(IConcept lhsConcept,
                              java.lang.String attributeName,
                              int index,
                              java.lang.String value,
                              IContext ctx)
                              throws InvalidTypeException,
                                     ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified string value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeString

void setBeliefAttributeString(IConcept lhsConcept,
                              java.lang.String attributeName,
                              java.lang.String key,
                              java.lang.String value,
                              IContext ctx)
                              throws InvalidTypeException,
                                     ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified string value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeSymbol

void setBeliefAttributeSymbol(IConcept lhsConcept,
                              java.lang.String attributeName,
                              java.lang.String value,
                              IContext ctx)
                              throws InvalidTypeException,
                                     ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified symbol value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type or the value is not a valid symbol
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeSymbol

void setBeliefAttributeSymbol(IConcept lhsConcept,
                              java.lang.String attributeName,
                              int index,
                              java.lang.String value,
                              IContext ctx)
                              throws InvalidTypeException,
                                     ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified symbol value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type or the value is not a valid symbol
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeSymbol

void setBeliefAttributeSymbol(IConcept lhsConcept,
                              java.lang.String attributeName,
                              java.lang.String key,
                              java.lang.String value,
                              IContext ctx)
                              throws InvalidTypeException,
                                     ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified symbol value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type or the value is not a valid symbol
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeJava

void setBeliefAttributeJava(IConcept lhsConcept,
                            java.lang.String attributeName,
                            java.io.Serializable value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Serializable value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new Java Serializable value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeJava

void setBeliefAttributeJava(IConcept lhsConcept,
                            java.lang.String attributeName,
                            int index,
                            java.io.Serializable value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Serializable value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new Java Serializable value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeJava

void setBeliefAttributeJava(IConcept lhsConcept,
                            java.lang.String attributeName,
                            java.lang.String key,
                            java.io.Serializable value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Serializable value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new Java Serializable value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeJava

void setBeliefAttributeJava(IConcept lhsConcept,
                            java.lang.String attributeName,
                            java.lang.Object value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Object value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new Java Object value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeJava

void setBeliefAttributeJava(IConcept lhsConcept,
                            java.lang.String attributeName,
                            int index,
                            java.lang.Object value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Object value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new Java Object value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeJava

void setBeliefAttributeJava(IConcept lhsConcept,
                            java.lang.String attributeName,
                            java.lang.String key,
                            java.lang.Object value,
                            IContext ctx)
                            throws InvalidTypeException,
                                   ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified Java Object value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new Java Object value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeConcept

void setBeliefAttributeConcept(IConcept lhsConcept,
                               java.lang.String attributeName,
                               IConcept value,
                               IContext ctx)
                               throws InvalidTypeException,
                                      ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified IConcept value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
value - the new IConcept value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeConcept

void setBeliefAttributeConcept(IConcept lhsConcept,
                               java.lang.String attributeName,
                               int index,
                               IConcept value,
                               IContext ctx)
                               throws InvalidTypeException,
                                      ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified IConcept value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to a value in the map
value - the new IConcept value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeConcept

void setBeliefAttributeConcept(IConcept lhsConcept,
                               java.lang.String attributeName,
                               java.lang.String key,
                               IConcept value,
                               IContext ctx)
                               throws InvalidTypeException,
                                      ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has a specified IConcept value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to a value in the map
value - the new IConcept value for the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeUnknown

void setBeliefAttributeUnknown(IConcept lhsConcept,
                               java.lang.String attributeName,
                               IContext ctx)
                               throws InvalidTypeException,
                                      ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has the unknown value for a named attribute

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a compatible type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeUnknown

void setBeliefAttributeUnknown(IConcept lhsConcept,
                               java.lang.String attributeName,
                               int index,
                               IContext ctx)
                               throws InvalidTypeException,
                                      ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has the unknown value for a named collection attribute at an int index

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
index - the integer index to be set to 'unknown' in the collection
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

setBeliefAttributeUnknown

void setBeliefAttributeUnknown(IConcept lhsConcept,
                               java.lang.String attributeName,
                               java.lang.String key,
                               IContext ctx)
                               throws InvalidTypeException,
                                      ExternalException
Creates and asserts a new belief in the belief state representing that an IConcept has the unknown value for a named collection attribute at a String key

Parameters:
lhsConcept - an IConcept to be given a new value for an attribute
attributeName - the String name of the attribute
key - the String key to be set to 'unknown' in the collection
ctx - an IContext for asserting the new belief
Throws:
InvalidTypeException - if the attribute does not have a collection type
ExternalException - if the concept does not have the named attribute or an internal error occurs

getBeliefRelationConcepts

java.util.List<IConcept> getBeliefRelationConcepts(IConcept lhsConcept,
                                                   java.lang.String relationName,
                                                   IContext ctx)
                                                   throws ExternalException
Retrieves a list of concepts that are related to a given concept by a named relation by inspecting the beliefs in the current belief state. Unknown values are filtered out of the returned list so that (concept relation unknown) will result in an empty list being returned.

Parameters:
lhsConcept - an IConcept whose values for a relation are to be retrieved
relationName - a String name for a relation defined for lhsConcept
ctx - the IContext used for the retrieval
Returns:
List the list of IConcept instances that are related to the lhsConcept by the relation
Throws:
ExternalException - if no attribute with the specified name is defined for this concept or an internal error occurs

hasBeliefRelationAnyValue

boolean hasBeliefRelationAnyValue(IConcept lhsConcept,
                                  java.lang.String relationName,
                                  boolean includeUnknown,
                                  IContext ctx)
                                  throws ExternalException
Tests whether there are any true beliefs for a given concept and named relation in the current belief state. If includeUnknown is true a belief with 'unknown' as the right-hand side value is counted, else it is ignored.

Parameters:
lhsConcept - an IConcept whose relation to another concept is to be checked
relationName - a String name for a relation defined for lhsConcept
includeUnknown - true if the unknown value is counted, else false
ctx - the IContext used for the retrieval
Returns:
boolean true if the specified relationship exists in the belief state, else false
Throws:
ExternalException - if no relation with the specified name is defined for this concept or an internal error occurs

hasBeliefRelationValue

boolean hasBeliefRelationValue(IConcept lhsConcept,
                               java.lang.String relationName,
                               java.lang.Object value,
                               IContext ctx)
                               throws ExternalException
Tests whether a concept is related to a value by a named relation by inspecting the beliefs in the current belief state.

Parameters:
lhsConcept - an IConcept whose values for a relation are to be checked
relationName - a String name for a relation defined for lhsConcept
value - an Object to be tested for the right-hand side of the relation
ctx - an IContext for testing the relation
Returns:
boolean true if the concept is related to the value by the relation, else false
Throws:
ExternalException - if no relation with the specified name is defined for this concept or an internal error occurs

addBeliefRelationConcept

void addBeliefRelationConcept(IConcept lhsConcept,
                              java.lang.String relationName,
                              IConcept rhsConcept,
                              IContext ctx)
                              throws ExternalException
Adds a concept as a value of a named relation for a concept by asserting a new belief into the belief state.

Parameters:
lhsConcept - an IConcept that gets a new concept related to it
relationName - a String name for a relation defined for lhsConcept
rhsConcept - the IConcept to be added to lhsConcept's relation
ctx - an IContext for asserting the new belief
Throws:
ExternalException - if the concept does not have the named relation or an internal error occurs

removeBeliefRelationConcept

void removeBeliefRelationConcept(IConcept lhsConcept,
                                 java.lang.String relationName,
                                 IConcept rhsConcept,
                                 IContext ctx)
                                 throws ExternalException
Removes a concept as a value of a named relation for a concept by retracting the corresponding belief from the belief state.

Parameters:
lhsConcept - an IConcept that has the relation value removed
relationName - a String name for a relation defined for lhsConcept
rhsConcept - the IConcept to be removed from the lhsConcept's relation
ctx - an IContext for retracting the belief
Throws:
ExternalException - if the concept does not have the named relation or an internal error occurs

setBeliefRelationUnknown

void setBeliefRelationUnknown(IConcept lhsConcept,
                              java.lang.String relationName,
                              IContext ctx)
                              throws ExternalException
Removes any existing concepts as values of a named relation for a concept by giving the relation a value of unknown.

Parameters:
lhsConcept - an IConcept for which a relation is set to unknown
relationName - a String name for a relation defined for lhsConcept
ctx - an IContext for asserting the belief with an unknown value
Throws:
ExternalException - if the concept does not have the named relation or an internal error occurs

removeAllBeliefRelationValues

java.util.List<IConcept> removeAllBeliefRelationValues(IConcept lhsConcept,
                                                       java.lang.String relationName,
                                                       IContext ctx)
                                                       throws ExternalException
Removes any existing concepts as values of a named relation for a concept by retracting beliefs from the belief state. Unlike setRelationUnknown, removeAllRelationValues does not give the relation a value of unknown

Parameters:
lhsConcept - an IConcept for which a relation is set to unknown
relationName - a String name for a relation defined for lhsConcept
ctx - an IContext for retracting the beliefs
Returns:
List the list of IConcept instances that have been removed from the relation for the lhsConcept
Throws:
ExternalException - if the concept does not have the named relation or an internal error occurs


Copyright © 1997-2012 All Rights Reserved.