AclListRights: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Server function}}
{{Server function}}
{{Needs Example}}
This function returns a table of all the rights that a given ACL has.
This function returns a table of all the rights that a given ACL has.


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
table aclListRights ( acl theACL )
table aclListRights ( acl theACL, string allowedType )
</syntaxhighlight>  
</syntaxhighlight>  
 
{{OOP||[[acl]]:listRights||}}
===Required Arguments===  
===Required Arguments===  
*'''theACL:''' The ACL to get the rights from
*'''theACL:''' The ACL to get the rights from
*'''allowedType:''' The allowed right type. Possible values are ''general'', ''function'', ''resource'' and ''command''


===Returns===
===Returns===
Line 16: Line 16:


==Example==  
==Example==  
<!-- Explain what the example is in a single sentance -->
This example outputs the rights of the given acl. (TESTED!)
This example does...
<syntaxhighlight lang="lua">addCommandHandler("aclRights",function(player,command,theAcl)
<!-- Add the code below, an emphasis should be on making it clear, not optimized. You could provide two versions if you wish, one clear and well commented, the other optimized -->
if(theAcl~="")then
<syntaxhighlight lang="lua">
rights = aclListRights(aclGet(theAcl))
--TODO
count = 0
for acl,list in pairs(rights)do
outputChatBox("ACL List: "..theAcl.." #"..tostring(count).." Right: "..list..".",player)
count = count + 1
end
else
outputChatBox("Please type in a acl that you want to retrieve the rights from.",player)
outputChatBox("Please use this Syntax: /aclRights theACL ",player)
end
end)
</syntaxhighlight>
</syntaxhighlight>


Line 26: Line 35:
<!-- Change FunctionArea to the area that this function is in on the main function list page, e.g. Server, Player, Vehicle etc -->
<!-- Change FunctionArea to the area that this function is in on the main function list page, e.g. Server, Player, Vehicle etc -->
{{ACL_functions}}
{{ACL_functions}}
[[Category:Needs_Example]] <!-- leave this until the example is completed. -->
[[zh-cn:aclListRights]]

Latest revision as of 08:36, 5 February 2021

This function returns a table of all the rights that a given ACL has.

Syntax

table aclListRights ( acl theACL, string allowedType )

OOP Syntax Help! I don't understand this!

Method: acl:listRights(...)


Required Arguments

  • theACL: The ACL to get the rights from
  • allowedType: The allowed right type. Possible values are general, function, resource and command

Returns

Returns a table over the rights as strings in the given ACL. This table might be empty. Returns false or nil if theACL is invalid or it fails for some other reason.

Example

This example outputs the rights of the given acl. (TESTED!)

addCommandHandler("aclRights",function(player,command,theAcl)
	if(theAcl~="")then
		rights = aclListRights(aclGet(theAcl))
		count = 0
		for acl,list in pairs(rights)do
			outputChatBox("ACL List: "..theAcl.." #"..tostring(count).." Right: "..list..".",player)
			count = count + 1
		end
	else
		outputChatBox("Please type in a acl that you want to retrieve the rights from.",player)
		outputChatBox("Please use this Syntax: /aclRights theACL ",player)
	end
end)

See Also