Manual Pages for UNIX Operating System command usage for man Exacct::Object::Group

Perl Library Functions               Exacct::Object::Group(3PERL)



NAME
     Exacct::Object::Group - exacct group manipulation

SYNOPSIS
     use Sun::Solaris::Exacct::Object;
     my $ea_grp = Sun::Solaris::Exacct::Object::Group->new(
        & EXT_GROUP | &EXC_DEFAULT | &EXD_GROUP_PROC);


DESCRIPTION
     This module is used for manipulating  libexacct(3LIB)  Group
     objects.  A  libexacct  Group  object  is  represented as an
     opaque       reference        blessed        into        the
     Sun::Solaris::Exacct::Object::Group  class,  which is a sub-
     class of the Sun::Solaris::Exacct::Object class.  The  Items
     within  a  Group are stored inside a Perl array. A reference
     to the array can be  accessed  with  the  inherited  value()
     method.  The  individual Items within a Group can be manipu-
     lated with the normal Perl array syntax and  operators.  All
     data  elements  of  the  array  must  be  derived  from  the
     Sun::Solaris::Exacct::Object class.  Group objects can  also
     be  nested  inside  each  other simply by adding an existing
     Group as a data Item.

  Constants
     None.

  Functions
     None.

  Class methods
     Class   methods   include   those   inherited    from    the
     Sun::Solaris::Exacct::Object base class, plus the following:

     new($catalog, @objects)    This method creates and returns a
                                new
                                Sun::Solaris::Exacct::Object::Group.
                                The  catalog tag can be either an
                                integer           or            a
                                Sun::Solaris::Exacct::Catalog.
                                The catalog tag should be a valid
                                catalog  tag  for  a  Perl exacct
                                Group object. The @objects param-
                                eter     is     a     list     of
                                Sun::Solaris::Exacct::Object   to
                                be  stored  inside  the  Group. A
                                copy of all the passed  Items  is
                                taken  and  any Group objects are
                                recursively copied. The  contents
                                of  the returned Group object can
                                be  accessed   with   the   array
                                returned by the value method.



SunOS 5.11           Last change: 1 Dec 2002                    1






Perl Library Functions               Exacct::Object::Group(3PERL)



  Object methods
     as_hash()        This method returns  the  contents  of  the
                      group  as  a  hash  reference.  It uses the
                      string value of each item's catalog  ID  as
                      the  hash  entry  key  and the scalar value
                      returned  by  value()  as  the  hash  entry
                      value.  This  form should be used if  there
                      are no duplicate catalog tags in the group.

                      This method and its companion as_hashlist()
                      are the fastest ways to access the contents
                      of a Group.


     as_hashlist()    This method returns  the  contents  of  the
                      group  as  a  hash  reference.  It uses the
                      string value of each item's catalog  id  as
                      the  hash  entry  key  and  an array of the
                      scalar values returned by  value()  as  the
                      hash  entry  value  for  all the items that
                      share a common key.  This  form  should  be
                      used  if  there  might be duplicate catalog
                      tags in the group.

                      This method and its companion as_hash() are
                      the  fastest ways to access the contents of
                      a Group.


  Exports
     None.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWpl5u                    |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
     Exacct(3PERL), Exacct::Catalog(3PERL),  Exacct::File(3PERL),
     Exacct::Object(3PERL),          Exacct::Object::Item(3PERL),
     libexacct(3LIB), attributes(5)




SunOS 5.11           Last change: 1 Dec 2002                    2