<HTML>
<HEAD>
<TITLE>ARSperl Manual - ars_GetCharMenuItem</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF">
<H2><CODE>ars_GetCharMenuItems(ctrl,name)</CODE></H2>
This function builds a "linked list" of menu items. It returns an
array pointer to the top level menu that is made up of
<I>(name, value)</I> pairs. If the <I>value</I> is, in turn, another
array pointer, then it points to a submenu structure. <P>
<B>Illustration</B>
<PRE>
@menu_struct
($name = "Item1" , $value = "This is item1")
.
.
.
($name = "Sub Menu", $value = array reference)
+------> @sub_menu_struct
($name = "SubItem1", $value = ...)
.
.
.
</PRE>
See <I>Show_Menu.pl</I> for a demonstration of using this function
and its output.<P>
<DL>
<DT><B>On success</B><DD>
A reference to an array.
<DT><B>On failure</B><DD>
<CODE>undef</CODE>.
</DL>
<P>Example:
<PRE>
$m = ars_GetCharMenuItems($ctrl, $menu_name));
@menu_struct = @$m;
</PRE>
<P>
<HR WIDTH="30%">
<P>
<A HREF="toc.html"><IMG ALT="<--" SRC="arrow.gif" ALIGN=CENTER> Table of Contents </A>
<p>
<address>
Last changes to this page 26th June 1997 by d.j.adams@soton.ac.uk<br>
© J.C.Murphy, J.W.Murphy 1997 arsperl@smurfland.cit.buffalo.edu
</address>
</BODY>
</HTML>