ZH-CN/AclCreate - Revision history

Myonlake at 18:09, 21 February 2021

2021-02-21T18:09:18Z

← Older revision		Revision as of 18:09, 21 February 2021
Line 49:		Line 49:
	==See Also==		==See Also==
	{{ACL_functions}}		{{ACL_functions}}

			[[ar:aclCreate]]
			[[en:aclCreate]]
	[[zh-cn:AclCreate]]		[[zh-cn:AclCreate]]
	~~[[en:AclCreate]]~~

Qwe7769611 at 09:31, 5 February 2021

2021-02-05T09:31:15Z

← Older revision		Revision as of 09:31, 5 February 2021
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Server function}}		{{Server function}}
	~~This function creates an ACL entry in the Access Control List system with the specified name~~.		此函数用于在访问控制列表系统中创建具有指定名称的ACL条目.

	==~~Syntax~~==		==语法==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	acl aclCreate ( string aclName )		acl aclCreate ( string aclName )
	</syntaxhighlight>		</syntaxhighlight>
	{{~~OOP~~\|\|[[ACL]]\|\|}}		{{OOP_ZH-CN\|\|[[ACL]]\|\|}}
	===~~Required Arguments~~===		===必填函数===
	*'''aclName:''' ~~The name of the ACL entry to add~~.		*'''aclName:''' 要添加的ACL条目的名称.

	===~~Returns~~===		===返回值===
	~~Returns the created ACL object if successful~~. ~~Returns false if an ACL of the given name could not be created~~.		如果成功，返回创建的ACL对象.如果无法创建给定名称的ACL，则返回false.

	==~~Example~~==		==示例==
	~~This example adds a command~~ ''setaclright'' ~~with which you can easily add new rights to specified access control lists~~.		此示例添加了命令 ''setaclright''，使用该命令可以轻松地向指定的访问控制列表添加新权限.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function setACLRight ( thePlayer, commandName, aclName, rightName, access )		function setACLRight ( thePlayer, commandName, aclName, rightName, access )
	-- ~~turn the boolean string to lower case~~		-- 将布尔字符串转换为小写
	access = string.lower ( access )		access = string.lower ( access )
	-- ~~access has to be either true or false (booleans)~~		-- 访问必须是true或false（布尔值）
	if not (access == "true" or access == "false") then		if not (access == "true" or access == "false") then
	-- ~~print out error message to debug window~~		-- 将错误消息发送到调试窗口
	return outputDebugString ( "Invalid access; true and false are only accepted", 1 )		return outputDebugString ( "Invalid access; true and false are only accepted", 1 )
	end		end

	-- ~~change the access to boolean~~		-- 将访问权限更改为布尔值
	if access == "true" then		if access == "true" then
	access = true		access = true
Line 34:		Line 34:

	local ourACL = aclGet ( aclName )		local ourACL = aclGet ( aclName )
	-- ~~if there is no previous ACL with this name, we need to create one~~		-- 如果以前没有具有此名称的ACL，则需要创建一个
	if not ourACL then		if not ourACL then
	ourACL = aclCreate ( aclName )		ourACL = aclCreate ( aclName )
Line 41:		Line 41:
	-- and finally let's set the right		-- and finally let's set the right
	aclSetRight ( ourACL, rightName, access )		aclSetRight ( ourACL, rightName, access )
	-- ~~don't forget to save the ACL after it has been modified~~		-- 不要忘记在修改ACL后保存它
	aclSave ()		aclSave ()
	end		end

Qwe7769611 at 08:39, 5 February 2021

2021-02-05T08:39:05Z

← Older revision		Revision as of 08:39, 5 February 2021
Line 50:		Line 50:
	{{ACL_functions}}		{{ACL_functions}}
	[[zh-cn:AclCreate]]		[[zh-cn:AclCreate]]
			[[en:AclCreate]]

Qwe7769611: Created page with "NOTOC {{Server function}} This function creates an ACL entry in the Access Control List system with the specified name. ==Syntax== acl aclC..."

2021-02-05T08:38:51Z

Created page with "__NOTOC__ {{Server function}} This function creates an ACL entry in the Access Control List system with the specified name. ==Syntax== <syntaxhighlight lang="lua"> acl aclC..."

New page

__NOTOC__
{{Server function}}
This function creates an ACL entry in the Access Control List system with the specified name.

==Syntax==
<syntaxhighlight lang="lua">
acl aclCreate ( string aclName )
</syntaxhighlight>
{{OOP||[[ACL]]||}}
===Required Arguments===
*'''aclName:''' The name of the ACL entry to add.

===Returns===
Returns the created ACL object if successful. Returns false if an ACL of the given name could not be created.

==Example==
This example adds a command ''setaclright'' with which you can easily add new rights to specified access control lists.
<syntaxhighlight lang="lua">
function setACLRight ( thePlayer, commandName, aclName, rightName, access )
-- turn the boolean string to lower case
access = string.lower ( access )
-- access has to be either true or false (booleans)
if not (access == "true" or access == "false") then
-- print out error message to debug window
return outputDebugString ( "Invalid access; true and false are only accepted", 1 )
end

-- change the access to boolean
if access == "true" then
access = true
else
access = false
end

local ourACL = aclGet ( aclName )
-- if there is no previous ACL with this name, we need to create one
if not ourACL then
ourACL = aclCreate ( aclName )
end

-- and finally let's set the right
aclSetRight ( ourACL, rightName, access )
-- don't forget to save the ACL after it has been modified
aclSave ()
end
addCommandHandler ( "setaclright", setACLRight )
</syntaxhighlight>

==See Also==
{{ACL_functions}}
[[zh-cn:AclCreate]]

ZH-CN/AclCreate - Revision history

Myonlake at 18:09, 21 February 2021

Qwe7769611 at 09:31, 5 February 2021

Qwe7769611 at 08:39, 5 February 2021

Qwe7769611: Created page with "__NOTOC__ {{Server function}} This function creates an ACL entry in the Access Control List system with the specified name. ==Syntax== acl aclC..."

Qwe7769611: Created page with "NOTOC {{Server function}} This function creates an ACL entry in the Access Control List system with the specified name. ==Syntax== acl aclC..."