Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

WWW::Search::Pagesjaunes
Lookup phones numbers from www.pagesjaunes.fr

WWW::Search::Pagesjaunes - Lookup phones numbers from www.pagesjaunes.fr



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" );

 do {

    print $_->entry . "\n" foreach ($pj->results);

 } while $pj->has_more;


DESCRIPTION

The WWW::Search::Pagesjaunes provides name, phone number and addresses of French telephone subscribers by using the http://www.pagesjaunes.fr 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($separator)
Returns the concatenation of the name and the phone number, separated by `` - ''. You can specify your own separator as first argument.


BUGS

The phone numbers are sometimes not correctly parsed, esp. when one entry has several phone numbers.

If you found a bug and want to report it or send a patch, you are encouraged to use the CPAN Request Tracker interface: https://rt.cpan.org/NoAuth/Dists.html?Queue=WWW-Search-Pagesjaunes


COPYRIGHT

Please read the Publisher information of http://www.pagesjaunes.fr available at the following URL: http://www.pagesjaunes.fr/pj.cgi

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>

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy