The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
JMURPHY / ARSperl-1.91 / html / manual / ars_SetContainer.html 
<HTML>
<HEAD>
<TITLE>ARSperl Programmer's Manual - ars_SetContainer</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF">

   <H2><CODE>ars_SetContainer(ctrl, name, containerHash)</CODE></H2>

      This function modifies an existing container. You must first
      populate the <CODE>containerHash</CODE> before calling this routine.
      <P><CODE>name</CODE> is the name of the container.
      <P><CODE>containerHash</CODE> is a partially assigned
      <A HREF="ds_container.html">Container Attributes</a> hash. 

      <P>

      <DL>
          <DT><B>On success</B><DD>
              Returns 1
          <DT><B>On failure</B><DD>
              Returns 0
      </DL>

      <P>Example:

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

      <PRE>
      ($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;
      </PRE>

<P>
<I>This function was introduced in version 1.90 of ARSperl</I>
<P>

<A HREF="toc.html"><IMG ALT="&lt;--" SRC="arrow.gif" ALIGN=CENTER> Back to Table of Contents </A>
</BODY>
</HTML>