<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="<--" SRC="arrow.gif" ALIGN=CENTER> Back to Table of Contents </A>
</BODY>
</HTML>