NAME

Geo::Postcodes - Base class for the Geo::Postcodes::XX modules

SYNOPSIS

This is the base class for the Geo::Postcodes::XX modules.

See the 'SUBCLASS' file for information on how to make your own subclass.

ABSTRACT

Geo::Postcodes - Base class for the Geo::Postcodes::XX modules. It is useless on its own.

COMMON FEATURES

The child classes inherit the following methods and procedures (through some black magic).

selection procedure

my @postcodes = Geo::Postcodes::NO::selection(method => $value);

Use this to get a list of all the postcodes associated with the specified method and value. The methods can be either one mentioned in the METHODS section, except selection.

Wildcards are supported, by placing one or more % in $value. The % will match zero or more arbitrary characters (as in standard SQL). Use . (a single period) to match exactly one character.

DEFECTIVE: Use | to combine searches; Location and %ÅS|%SKOG will give all locations ending with "ÅS" or "SKOG". CAVEAT: This will enter an implicit % before and after the |, if not given.

The match is done case insensitive, but this does not work for the special norwegian and danish characters 'Æ', 'Ø' and 'Å'.

selection method

my @postcodobjects = Geo::Postcodes::NO->selection(method => $value);

This works just as the procedure version (see above), but will return a list of postcode objects (instead of a list of postcodes).

DESCRIPTION

CAVEAT

This module uses "inside out objects".

SEE ALSO

The latest version of this library should always be available on CPAN, but see also the library home page; http://bbop.org/perl/GeoPostcodes for addittional information and sample usage.

AUTHOR

Arne Sommer, <arne@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2006 by Arne Sommer

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.