Opcje wyszukiwania podręcznika man:
Lista stron man zaczynających się od znaku:
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z   ALPHA   NUM   OTHER   ALL
User::Identity::LocatiUserpContributed Perl DocumUser::Identity::Location(3pm)

       User::Identity::Location - physical location of a person

          is an User::Identity::Item

        use User::Identity;
        use User::Identity::Location;
        my $me   = User::Identity->new(...);
        my $addr = User::Identity::Location->new(...);
        $me->add(location => $addr);

        # Simpler

        use User::Identity;
        my $me   = User::Identity->new(...);
        my $addr = $me->add(location => ...);

       The "User::Identity::Location" object contains the description of a
       physical location of a person: home, work, travel.  The locations are
       collected by a User::Identity::Collection::Locations object.

       Nearly all methods can return "undef".  Some methods produce language
       or country specific output.


       User::Identity::Location->new([NAME], OPTIONS)

           Create a new location.  You can specify a name as first argument,
           or in the OPTION list.  Without a specific name, the organization
           is used as name.

            Option      --Defined in     --Default
            country                        undef
            country_code                   undef
            description   User::Identity::Item  undef
            fax                            undef
            name          User::Identity::Item  <required>
            organization                   undef
            parent        User::Identity::Item  undef
            pc                             undef
            phone                          undef
            pobox                          undef
            pobox_pc                       undef
            postal_code                    <value of option pc>
            state                          undef
            street                         undef

           . country => STRING

           . country_code => STRING

           . description => STRING

           . fax => STRING|ARRAY

           . name => STRING

           . organization => STRING

           . parent => OBJECT

           . pc => STRING

               Short name for "postal_code".

           . phone => STRING|ARRAY

           . pobox => STRING

           . pobox_pc => STRING

           . postal_code => STRING

           . state => STRING

           . street => STRING



           The city where the address is located.


           The country where the address is located.  If the name of the coun-
           try is not known but a country code is defined, the name will be
           looked-up using Geography::Countries (if installed).


           Each country has an ISO standard abbreviation.  Specify the country
           or the country code, and the other will be filled in automatically.


           See "Attributes" in User::Identity::Item


           One or more fax numbers, like phone().


           Create an address to put on a postal mailing, in the format as nor-
           mal in the country where it must go to.  To be able to achieve
           that, the country code must be known.  If the city is not specified
           or no street or pobox is given, undef will be returned: an incom-
           plete address.


            print $uil->fullAddress;
            print $user->find(location => 'home')->fullAddress;


           See "Attributes" in User::Identity::Item


           The organization (for instance company) which is related to this


           One or more phone numbers.  Please use the internation notation,
           which starts with '+', for instance "+31-26-12131".  In scalar con-
           text, only the first number is produced.  In list context, all num-
           bers are presented.


           Post Office mail box specification.  Use "P.O.Box 314", not simple


           The postal code related to the Post-Office mail box.  Defined by
           new() option "pobox_pc".


           The postal code is very country dependent.  Also, the location of
           the code within the formatted string is country dependent.


           The state, which is important for some contries but certainly not
           for the smaller ones.  Only set this value when you state has to
           appear on printed addresses.


           Returns the address of this location.  Since Perl 5.7.3, you can
           use unicode in strings, so why not format the address nicely?


       $obj->add(COLLECTION, ROLE)

           See "Collections" in User::Identity::Item

       $obj->addCollection(OBJECT | ([TYPE], OPTIONS))

           See "Collections" in User::Identity::Item


           See "Collections" in User::Identity::Item

       $obj->find(COLLECTION, ROLE)

           See "Collections" in User::Identity::Item


           See "Collections" in User::Identity::Item


           See "Collections" in User::Identity::Item



           See "Collections" in User::Identity::Item


           See "Collections" in User::Identity::Item

       Error: $object is not a collection.

           The first argument is an object, but not of a class which extends

       Error: Cannot load collection module for $type ($class).

           Either the specified $type does not exist, or that module named
           $class returns compilation errors.  If the type as specified in the
           warning is not the name of a package, you specified a nickname
           which was not defined.  Maybe you forgot the 'require' the package
           which defines the nickname.

       Error: Creation of a collection via $class failed.

           The $class did compile, but it was not possible to create an object
           of that class using the options you specified.

       Error: Don't know what type of collection you want to add.

           If you add a collection, it must either by a collection object or a
           list of options which can be used to create a collection object.
           In the latter case, the type of collection must be specified.

       Warning: No collection $name

           The collection with $name does not exist and can not be created.

       This module is part of User-Identity distribution version 0.92, built
       on July 25, 2007. Website:

       Copyrights 2003,2004,2007 by Mark Overmeer <>. For
       other contributors see Changes.

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

perl v5.8.8                       2008-02-28     User::Identity::Location(3pm)

Time taken: 0.00047 seconds

Created with the man page lookup class by Andrew Collington,