Added in 1.6.0 r22273

This function returns a table of all groups the object is in.

Syntax

table aclObjectGetGroups ( string theObject )

Required Arguments

• theObject: The name of the ACL entry to get groups of.

Returns

• table: groups list

Returns a table of all groups the object is in on success, false if something went wrong.

Code Examples

Example 1 Example 2 (OOP)

server

This example outputs a list of all groups of the calling user.

addCommandHandler("listGroups", function(player)
  local account = getPlayerAccount(player)
  if (not account or isGuestAccount(account)) then
    return
  end

  outputChatBox('Groups:', player)
  local groups = aclObjectGetGroups('user.'..getAccountName(account))

  for _,v in ipairs(groups) do
    outputChatBox('* '..aclGroupGetName(v), player)
  end
end)

server

OOP Required

This example outputs a list of all groups of the calling user.

addCommandHandler("listGroups", function(player)
  local account = player.account
  if (not account or account.guest) then
    return
  end

  player:outputChat('Groups:')
  local groups = aclObjectGetGroups('user.'..account.name)

  for _,v in ipairs(groups) do
    player:outputChat('* '..v.name)
  end
end)

See Also

ACL Functions

• aclCreate
• aclDestroy
• aclCreateGroup
• aclGet
• aclGetRight
• aclGetName
• aclGroupAddACL
• aclGroupAddObject
• aclDestroyGroup
• aclGetGroup
• aclGroupGetName
• aclGroupList
• aclGroupRemoveACL
• aclGroupListACL
• aclList
• aclListRights
• aclGroupListObjects
• aclGroupRemoveObject
• aclObjectGetGroups
• aclReload
• aclRemoveRight
• aclSave
• hasObjectPermissionTo
• isObjectInACLGroup
• aclSetRight

ACL Elements

• aclgroup
• acl

Reference

• Scripting Functions