Set::NestedGroups(3) grouped data eg ACL's, city/state/country etc


add ( $member, $group)
adds a member to a group. The group will be created if it doesn't already exist.
remove ( $member
, $group )
removes a member from a group. If this was the last member in this group, then the group will be deleted. If the member was only in this group, then the member will be deleted.
Outputs the object to the given filehandle, which must be already open in write mode.

The format is compatable with the format used by

CGI, and can be used with new to initialize a new object;

Returns true if successfully wrote the data, or false if something went wrong (usually that meant that the handle wasn't already open in write mode).

Saves the object to a DBI database. This can be used with new to initialize a new object. The $sth should be expecting 2 values, in this fashion:

  $sth = $dbh->prepare('insert into acl values (?,?)')

  $sth = $dbh->prepare('select * from acl');
  $newacl=new ACL($sth);

Returns true if successfully wrote the data, or false if something went wrong.

member ( $member, $group )
Returns true if $member
is a member of $group.
member ( $member )
returns true if $member exists in any group.
group ( $group )
returns true if $group exists
groups ( $member, %options )
Returns the groups that $member
belongs to. Options are explained below.
members ( $group , %options )
Returns the members of $group
. Keep on reading for the options
Returns a Set::NestedGroups::Member object that will output an list of the members & groups. This could be considered a calling of groups() on each member, except this is more efficent.

The object can be used as follows.

  for(my $i=0;$i<$list->rows();$i++){
    my ($member,$group)=$list->next();
    print "$member=$group\n";   


By default, the above methods give every valid combination. However you might not always want that. Therefore there are options which can prevent return of certain values.

All of these examples presume that 'joe' is a member of 'managers', and 'managers' is a member of payroll, and that you are using only one of these options. You can use all 3, but that gets complicated to explain.


No Recursion is performed, method would ignore payroll, and return only managers.


Doesn't returns groups 'in the middle', method would ignore mangers, and return only payroll.


Doesn't return members that are groups. This only applies to the list() method, in which case it acts like nomiddles, except on the member instead of the group. list would ignore managers and return joe => managers , joe => payroll.

This sounds a lot more confusing than it actually is, once you try it once or twice you'll get the idea.