Item (locate a particular rule)

Top  Previous  Next

 

Item

( | rulename | )

 

 | position   |

Item

Locates a specified rule and retrieves its entry from the broken rule queue. t.

rulename

A string constant, variable, EQUATE, or expression that contains the name of the rule to be located. If rule names are not unique within the collection managed by this RuleManager object, results may be unpredictable.

position

A string constant, variable, EQUATE, or expression that contains a numeric value corresponding to the position in the broken rule queue of the rule to be located.

The Item method locates the specified rule and returns the address of its Rule object. If the specified rule name does not exist in the broken rule queue or if the specified position is outside the range of entries in the broken rule queue, the Item method returns zero.

Return Data Type:     LONG

Example:

RulesCollection.BrokenRuleCount PROCEDURE

LBR             &Rule

NumberOfRules   LONG

Counter         LONG

RetVal          LONG

 

   CODE

   NumberOfRules = SELF.RuleCount()

   LOOP Counter = 1 TO NumberOfRules

       LBR &= SELF.Item(Counter)  

       IF LBR.GetIsBroken()

          Retval += 1

       END

   END

   RETURN(Retval)