ARSperl Programmer's Manual - ars_CreateActiveLink

## `ars_CreateActiveLink(ctrl, activeLinkHash)`

This function creates an new active link. You must first populate the `activeLinkHash` before calling this routine. `activeLinkHash` is an Active Link Attributes hash.

On success
  Returns 1
On failure
  Returns 0

Example:

> This example copies an existing active link to a new active link. I.e. it simply re-saves the active link under a new name.

          ($a = ars_GetActiveLink($c, "AL-foobar")) ||
    	    die $ars_errstr;
          $a->{name} = "Copy of ".$a->{name};
          ars_CreateActiveLink($c, $a) || die $ars_errstr;

Notes: Hash keys `helpText, owner` and `changeDiary` are optional when calling this routine.

This function was introduced in version 1.50 of ARSperl

Back to Table of Contents