ars_CreateFilter(ctrl, filterHash)

This function creates a new filter. You must first populate the filterHash before calling this routine.

filterHash is a Filter Attributes hash.

On success
Returns 1
On failure
Returns 0

Example:

This example copies an existing filter to a new filter. I.e. it simply re-saves the filter under a new name.
      ($f = ars_GetFilter($c, "F-foobar")) ||
	    die $ars_errstr;
      $f->{name} = "Copy of ".$f->{name};
      ars_CreateFilter($c, $f) || die $ars_errstr;
      
Notes: Hash keys helpText, owner and changeDiary are optional when calling this routine.

This function was introduced in version 1.90 of ARSperl

<-- Back to Table of Contents