ARSperl Programmer's Manual - ars_CreateFilter

## `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