home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _9ff40e953f9e46cd3fbdbd0330397314 < prev    next >
Text File  |  2000-03-23  |  6KB  |  151 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>WWW::Search::Google - class for searching Google</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::Google - class for searching Google</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="#linux search">LINUX SEARCH</A></LI>
  26.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  27.     <LI><A HREF="#how does it work">HOW DOES IT WORK?</A></LI>
  28.     <LI><A HREF="#testing">TESTING</A></LI>
  29.     <LI><A HREF="#author">AUTHOR</A></LI>
  30.     <LI><A HREF="#bugs">BUGS</A></LI>
  31.     <LI><A HREF="#version history">VERSION HISTORY</A></LI>
  32.     <LI><A HREF="#legalese">LEGALESE</A></LI>
  33. </UL>
  34. <!-- INDEX END -->
  35.  
  36. <HR>
  37. <P>
  38. <H1><A NAME="name">NAME</A></H1>
  39. <P>WWW::Search::Google - class for searching Google</P>
  40. <P>
  41. <HR>
  42. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  43. <UL>
  44. <LI>Linux</LI>
  45. <LI>Solaris</LI>
  46. <LI>Windows</LI>
  47. </UL>
  48. <HR>
  49. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  50. <P>use WWW::Search;
  51. my $Search = new WWW::Search('Google'); # cAsE matters
  52. my $Query = WWW::Search::escape_query(``Where is Jimbo'');
  53. $Search->native_query($Query);
  54. while (my $Result = $Search-><CODE>next_result())</CODE> {
  55. print $Result->url, ``\n'';
  56. }</P>
  57. <P>
  58. <HR>
  59. <H1><A NAME="description">DESCRIPTION</A></H1>
  60. <P>This class is a Google specialization of WWW::Search.
  61. It handles making and interpreting Google searches.
  62. <EM><A HREF="http://www.google.com">http://www.google.com</A></EM>.</P>
  63. <P>Googles returns 100 Hits per page. Custom Linux Only search capable.</P>
  64. <P>This class exports no public interface; all interaction should
  65. be done through <A HREF="../../../../site/lib/WWW/Search.html">the WWW::Search manpage</A> objects.</P>
  66. <P>
  67. <HR>
  68. <H1><A NAME="linux search">LINUX SEARCH</A></H1>
  69. <P>For LINUX lovers like me, you can put Googles in a LINUX only search
  70. mode by changing search URL from:</P>
  71. <PRE>
  72.  'search_url' => '<A HREF="http://www.google.com/search">http://www.google.com/search</A>',</PRE>
  73. <P>to:</P>
  74. <PRE>
  75.  'search_url' => '<A HREF="http://www.google.com/linux">http://www.google.com/linux</A>',</PRE>
  76. <P>
  77. <HR>
  78. <H1><A NAME="see also">SEE ALSO</A></H1>
  79. <P>To make new back-ends, see <A HREF="../../../../site/lib/WWW/Search.html">the WWW::Search manpage</A>.</P>
  80. <P>
  81. <HR>
  82. <H1><A NAME="how does it work">HOW DOES IT WORK?</A></H1>
  83. <P><CODE>native_setup_search</CODE> is called (from <CODE>WWW::Search::setup_search</CODE>)
  84. before we do anything.  It initializes our private variables (which
  85. all begin with underscore) and sets up a URL to the first results
  86. page in <CODE>{_next_url}</CODE>.</P>
  87. <P><CODE>native_retrieve_some</CODE> is called (from <CODE>WWW::Search::retrieve_some</CODE>)
  88. whenever more hits are needed.  It calls <CODE>WWW::Search::http_request</CODE>
  89. to fetch the page specified by <CODE>{_next_url}</CODE>.
  90. It then parses this page, appending any search hits it finds to 
  91. <CODE>{cache}</CODE>.  If it finds a ``next'' button in the text,
  92. it sets <CODE>{_next_url}</CODE> to point to the page for the next
  93. set of results, otherwise it sets it to undef to indicate we''re done.</P>
  94. <P>
  95. <HR>
  96. <H1><A NAME="testing">TESTING</A></H1>
  97. <P>This module adheres to the <CODE>WWW::Search</CODE> test suite mechanism.</P>
  98. <P>
  99. <HR>
  100. <H1><A NAME="author">AUTHOR</A></H1>
  101. <P>This backend is written and maintained/supported by Jim Smyser.
  102. <<A HREF="mailto:jsmyser@bigfoot.com">jsmyser@bigfoot.com</A>></P>
  103. <P>
  104. <HR>
  105. <H1><A NAME="bugs">BUGS</A></H1>
  106. <P>Google is not an easy search engine to parse in that it is capable 
  107. of altering it's output ever so slightly on different search terms.
  108. There may be new slight results output the author has not yet seen that
  109. will pop at any given time for certain searches. So, if you think you see
  110. a bug keep the above in mind and send me the search words you used so I
  111. may code for any new variations.</P>
  112. <P>
  113. <HR>
  114. <H1><A NAME="version history">VERSION HISTORY</A></H1>
  115. <P>2.13
  116. New regexp to parse newly found results format with certain search terms.</P>
  117. <P>2.10
  118. removed warning on absence of description; new test case</P>
  119. <P>2.09
  120. Google NOW returning url and title on one line.</P>
  121. <P>2.07
  122. Added a new parsing routine for yet another found result line.
  123. Added a substitute for whacky url links some queries can produce.
  124. Added Kingpin's new <CODE>hash_to_cgi_string()</CODE> 10/12/99</P>
  125. <P>2.06
  126. Fixed missing links / regexp crap.</P>
  127. <P>2.05
  128. Matching overhaul to get the code parsing right due to multiple 
  129. tags being used by google on the hit lines. 9/25/99</P>
  130. <P>2.02
  131. Last Minute description changes  7/13/99</P>
  132. <P>2.01
  133. New test mechanism  7/13/99</P>
  134. <P>1.00
  135. First release  7/11/99</P>
  136. <P>
  137. <HR>
  138. <H1><A NAME="legalese">LEGALESE</A></H1>
  139. <P>THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  140. WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  141. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.</P>
  142. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  143. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  144. <STRONG><P CLASS=block> WWW::Search::Google - class for searching Google</P></STRONG>
  145. </TD></TR>
  146. </TABLE>
  147.  
  148. </BODY>
  149.  
  150. </HTML>
  151.