home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _efe820a3441c01781e5fd6f4b741f48d < prev    next >
Text File  |  2000-03-23  |  5KB  |  123 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>WWW::Search::LookSmart - class for searching LookSmart</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> WWW::Search::LookSmart - class for searching LookSmart</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="#see also">SEE ALSO</A></LI>
  26.     <LI><A HREF="#how does it work">HOW DOES IT WORK?</A></LI>
  27.     <LI><A HREF="#testing">TESTING</A></LI>
  28.     <LI><A HREF="#author">AUTHOR</A></LI>
  29.     <LI><A HREF="#legalese">LEGALESE</A></LI>
  30.     <LI><A HREF="#version history">VERSION HISTORY</A></LI>
  31. </UL>
  32. <!-- INDEX END -->
  33.  
  34. <HR>
  35. <P>
  36. <H1><A NAME="name">NAME</A></H1>
  37. <P>WWW::Search::LookSmart - class for searching LookSmart</P>
  38. <P>
  39. <HR>
  40. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  41. <UL>
  42. <LI>Linux</LI>
  43. <LI>Solaris</LI>
  44. <LI>Windows</LI>
  45. </UL>
  46. <HR>
  47. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  48. <P>use WWW::Search;
  49. my $Search = new WWW::Search('LookSmart'); # cAsE matters
  50. my $Query = WWW::Search::escape_query(``Where is Jimbo'');
  51. $Search->native_query($Query);
  52. while (my $Result = $Search-><CODE>next_result())</CODE> {
  53. print $Result->url, ``\n'';
  54. }</P>
  55. <P>
  56. <HR>
  57. <H1><A NAME="description">DESCRIPTION</A></H1>
  58. <P>This class is a LookSmart specialization of WWW::Search.
  59. It handles making and interpreting LookSmart searches
  60. <EM><A HREF="http://looksmart.com">http://looksmart.com</A></EM>.</P>
  61. <P>LookSmart will first display it's own internal site results
  62. from it's many categories if found there, else it will 
  63. return outside results from the web. Thus, depending on the
  64. query there will be slightly two different formats returned
  65. depending on whether or not LookSmart finds them in it's own
  66. internal categories. All in all, this is a nice search engine!</P>
  67. <P>LookSmart only returns 10 hits per page and there is no search
  68. options.</P>
  69. <P>This class exports no public interface; all interaction should
  70. be done through <A HREF="../../../../site/lib/WWW/Search.html">the WWW::Search manpage</A> objects.</P>
  71. <P>
  72. <HR>
  73. <H1><A NAME="see also">SEE ALSO</A></H1>
  74. <P>To make new back-ends, see <A HREF="../../../../site/lib/WWW/Search.html">the WWW::Search manpage</A>.</P>
  75. <P>
  76. <HR>
  77. <H1><A NAME="how does it work">HOW DOES IT WORK?</A></H1>
  78. <P><CODE>native_setup_search</CODE> is called (from <CODE>WWW::Search::setup_search</CODE>)
  79. before we do anything.  It initializes our private variables (which
  80. all begin with underscore) and sets up a URL to the first results
  81. page in <CODE>{_next_url}</CODE>.</P>
  82. <P><CODE>native_retrieve_some</CODE> is called (from <CODE>WWW::Search::retrieve_some</CODE>)
  83. whenever more hits are needed.  It calls <CODE>WWW::Search::http_request</CODE>
  84. to fetch the page specified by <CODE>{_next_url}</CODE>.
  85. It then parses this page, appending any search hits it finds to 
  86. <CODE>{cache}</CODE>.  If it finds a ``next'' button in the text,
  87. it sets <CODE>{_next_url}</CODE> to point to the page for the next
  88. set of results, otherwise it sets it to undef to indicate we''re done.</P>
  89. <P>
  90. <HR>
  91. <H1><A NAME="testing">TESTING</A></H1>
  92. <P>This module adheres to the <CODE>WWW::Search</CODE> test suite mechanism. 
  93. See $TEST_CASES below.</P>
  94. <P>
  95. <HR>
  96. <H1><A NAME="author this backend is maintained and supported by jim smyser. <jsmyser@bigfoot.com>">AUTHOR
  97. This backend is maintained and supported by Jim Smyser.
  98. <<A HREF="mailto:jsmyser@bigfoot.com">jsmyser@bigfoot.com</A>></A></H1>
  99. <P><CODE>WWW::Search::NorthernLight</CODE> was originally written by Andreas Borchert
  100. based on <CODE>WWW::Search::Excite</CODE>.</P>
  101. <P>
  102. <HR>
  103. <H1><A NAME="legalese">LEGALESE</A></H1>
  104. <P>THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  105. WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  106. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.</P>
  107. <P>
  108. <HR>
  109. <H1><A NAME="version history">VERSION HISTORY</A></H1>
  110. <P>2.01
  111. New test mechanism</P>
  112. <P>1.00
  113. First release</P>
  114. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  115. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  116. <STRONG><P CLASS=block> WWW::Search::LookSmart - class for searching LookSmart</P></STRONG>
  117. </TD></TR>
  118. </TABLE>
  119.  
  120. </BODY>
  121.  
  122. </HTML>
  123.