ARSperl Programmer's Manual - ars_SetContainer

## `ars_SetContainer(ctrl, name, containerHash)`

This function modifies an existing container. You must first populate the `containerHash` before calling this routine.

`name` is the name of the container.

`containerHash` is a partially assigned Container Attributes hash.

On success
  Returns 1
On failure
  Returns 0

Example:

> This example changes the name of the container "TEST:FilterGuide". It also adds a filter to the end of the list.

          ($ct = ars_GetContainer($c, "TEST:FilterGuide")) ||
    	    die $ars_errstr;

          push @{$ct->{referenceList}}, {
            type => 3,
            name => "TEST:Filter",
            dataType => 0,
            description => "",
            label => "",
          };

          ars_SetContainer( $c, "TEST:FilterGuide", {
            name => "TEST:FilterGuide 2",
            referenceList => $ct->{referenceList},
          } ) || die $ars_errstr;

This function was introduced in version 1.90 of ARSperl

Back to Table of Contents