ars_perl_Qualifier($qual)

This function returns a Hash that contains a processed version of the qualifier structer (i.e. what is retured by ars_LoadQualifier or what is encoded in the qualifier structure that appears when you examine Filters and Active links via the Perl extension). You can then walk the various segments of the Hash and interpret the Qualifier.

Note that this is a fairly complex Hash and if all you want to do is see the qualifier in a readable form (and not interpret it) you might just want to call ars_Export and extract the readable qualifier from the return value of that routine.

On success
Returns the new entry id.
On failure
Returns undef.

Example:

      ($entry_id = ars_CreateEntry($c, "Schema01", $id, $val)) || 
            die $ars_errstr;
      

Hash: the hash returned by ars_perl_Qualifier has these members:

Note this is an incomplete description. We will complete the doc on this Hash in the future
 oper   = "and", "or", "not", "rel_op"
 left   = qualifier             (only for and, or)
 right  = qualifier             (only for and, or)
 not    = qualifier             (only for not)
 rel_op = rel_op                (only for rel_op)

a rel_op is:
 oper   = "==", ">", ">=", "<", "<=", "!=", "like", "in"
 left   = FieldValueOrArithStruct 
 right  = FieldValueOrArithStruct

FieldValueOrArithStruct is:
 fieldId        = integer 
 value          = scalar value (integer, string, float, etc.) 
 arith          = ArithOpStruct 
 statHistory    = StatHistoryValue
 valueSet       = list of scalar values 
 variable       = integer       /* I think this is for passing
                                   macro arguments */ 
 queryValue     = QueryValueStruct 
 queryCurrent   = integer

<-- Back to Table of Contents