home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _54f4784d11a7d40284c36b3924755c05 < prev    next >
Text File  |  2000-03-23  |  3KB  |  90 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Set::Scalar::Valued - valued sets</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Set::Scalar::Valued - valued sets</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#author">AUTHOR</A></LI>
  26. </UL>
  27. <!-- INDEX END -->
  28.  
  29. <HR>
  30. <P>
  31. <HR>
  32. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  33. <UL>
  34. <LI>Linux</LI>
  35. <LI>Solaris</LI>
  36. <LI>Windows</LI>
  37. </UL>
  38. <HR>
  39. <H1><A NAME="name">NAME</A></H1>
  40. <P>Set::Scalar::Valued - valued sets</P>
  41. <P>
  42. <HR>
  43. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  44. <PRE>
  45.     use Set::Scalar::Valued;
  46.     $s = Set::Scalar::Valued->new;
  47.     $s->insert(a => 12, 'b c' => $d);
  48.     $s->delete('b c' => $d);
  49.     $t = Set::Scalar->new(x => $y, y => $z);</PRE>
  50. <P>
  51. <HR>
  52. <H1><A NAME="description">DESCRIPTION</A></H1>
  53. <P>Valued sets are an extension of the traditional set concept.  In
  54. addition to a member just existing in the set, the member also has a
  55. distinct value.  You can think of this a combination of a traditional
  56. set and a Perl hash.</P>
  57. <P>The used methods are as for the traditional of Set::Scalar, with
  58. the difference that when creating (new()) or modifying (insert(),
  59. delete(), invert()), you must supply twice the number of arguments:
  60. the member-value pairs, instead of just the members.  Note, though,
  61. that in the current implementation of <A HREF="../../../../lib/Pod/perlfunc.html#item_delete"><CODE>delete()</CODE></A> the value half is
  62. unused, the deletion is by the member.  In future implementation
  63. this behavior may change so that also the value matters.</P>
  64. <P>There are a couple of additional methods:</P>
  65. <PRE>
  66.     %ve = $s->valued_members;</PRE>
  67. <P>which returns the member-value pairs, and</P>
  68. <PRE>
  69.     @v  = $s->values;</PRE>
  70. <P>which returns just the values (in the same order as the <CODE>members()</CODE>
  71. method would return the members), and</P>
  72. <PRE>
  73.     $v  = $s->value($member);</PRE>
  74. <P>which returns the value of the member.</P>
  75. <P>The display format of a valued set is the member-value pairs separated
  76. by `` => '', the pairs separated by ``, '' and enclosed in curly brackets {}.</P>
  77. <P>
  78. <HR>
  79. <H1><A NAME="author">AUTHOR</A></H1>
  80. <P>Jarkko Hietaniemi <<A HREF="mailto:jhi@iki.fi">jhi@iki.fi</A>></P>
  81. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  82. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  83. <STRONG><P CLASS=block> Set::Scalar::Valued - valued sets</P></STRONG>
  84. </TD></TR>
  85. </TABLE>
  86.  
  87. </BODY>
  88.  
  89. </HTML>
  90.