NAME WWW::Search::Pagesjaunes - Lookup phones numbers from www.pagesjaunes.fr SYNOPSIS use WWW::Search::Pagesjaunes; my $pj = new WWW::Search::Pagesjaunes; $pj->find( activite => "Plombier", localite => "Paris" ); { print $_->entry . "\n" foreach ($pj->results); redo if $pj->has_more; } DESCRIPTION The WWW::Search::Pagesjaunes provides name, phone number and addresses of French telephone subscribers by using the directory. METHODS Two classes are used in this module, a first one (WWW::Search::Pagesjaunes) to do the fetching and parsing, and the second one and a second one (WWW::Search::Pagesjaunes::Entry) holding the entry infos. Here are the methods for the main WWW::Search::Pagesjaunes module: new() The constructor accept an optional LWP::UserAgent as argument, if you want to provide your own. find( %request ) Here are the values for the %request hash that are understood. They each have two name, the first is the french one and the second is the english one: nom / name Name of the person you're looking for. activite / business Business type of the company you're looking for. Note that if this field is filled, the module searches in the yellow pages. localite / town Name of the town you're searching in. prenom / firstname First name of the person you're looking for. It is not set if you set the 'activite' field. departement / district Name or number of the Département or Région you're searching in. results() Returns an array of WWW::Search::Pagesjaunes::Entry containing the first matches of the query. limit($max_number_of_entries) Set the maximum number of entries returned. Default to 50. has_more() If the query leads to more than a few results, the field has_more is set. You can then call the results() method again to fetch the datas. The WWW::Search::Pagesjaunes::Entry class has six methods: new($name, $address, $phone, $fax) Returns a new WWW::Search::Pagesjaunes::Entry. name Returns the name of the entry. address Returns the address of the entry. phone Returns the phone number of the entry. is_fax Returns true if the phone number is a fax one, false otherwise. Note that currently, this method always returns 0. entry Returns the concatenation of the name and the phone number, separated by " - ". BUGS The phone numbers are sometimes not correctly parsed, esp. when one entry has several phone numbers. Names are sometimes truncated. If you found a bug and want to report it or send a patch, you are encouraged to use the CPAN Request Tracker interface: COPYRIGHT Please read the Publisher information of available at the following URL: WWW::Search::Pagesjaunes is Copyright (C) 2002, Briac Pilpré This module is free software; you can redistribute it or modify it under the same terms as Perl itself. AUTHOR Briac Pilpré briac@cpan.org