IsResourceArchived: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (isResourceArchived is server only, not shared)
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server function}}
{{Server function}}
{{New feature/item|3.0155|1.5.5|11533|
{{New feature/item|3.0155|1.5.5|11550|
Checks whether a resource is currently archived (running from within a ZIP file).
Checks whether the specified resource is archived. (Currently running from a ZIP file)
}}
}}


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">bool isResourceArchived ( resource resourceElement )</syntaxhighlight>
<syntaxhighlight lang="lua">bool isResourceArchived(resource resourceElement)</syntaxhighlight>
{{OOP||[[resource]]:isArchived|archived|}}
{{OOP||[[resource]]:isArchived|archived|}}
===Required Arguments===
===Required Arguments===
*'''resource:''' the resource to check
*'''resourceElement:''' The resource to check.


===Returns===
===Returns===
Returns ''true'' if a resource is archived, ''false'' if it is not archived, or ''false'' if there is problem with resource.
Returns '''true''' if the selected resource is archived, '''false''' if it is not archived, and '''nil''' if some kind of problem occurred.


==Example==
==Example==
<section name="Example 1" class="server" show="true">
This example stops the resource if it's archived.
<syntaxhighlight lang="lua">
addEventHandler("onResourceStart", resourceRoot,
function(resourceElement)
if isResourceArchived(resourceElement) then
cancelEvent()
end
end
)
</syntaxhighlight>
</section>
<section name="Example 2 (OOP)" class="server" show="true">
This example stops the resource if it's archived by using the object oriented method. '''(It's important to note that you need to enable OOP in meta.xml to use this)'''
<syntaxhighlight lang="lua">
addEventHandler("onResourceStart", resourceRoot,
function(resourceElement)
if resourceElement:isArchived() then
cancelEvent()
end
end
)
</syntaxhighlight>
</section>


{{Example}}
<section name="Example 3 (OOP)" class="server" show="true">
This example stops the resource if it's archived by using the object oriented variable. '''(It's important to note that you need to enable OOP in meta.xml to use this)'''
<syntaxhighlight lang="lua">
addEventHandler("onResourceStart", resourceRoot,
function(resourceElement)
if resourceElement.archived then
cancelEvent()
end
end
)
</syntaxhighlight>
</section>


==See Also==
==See Also==
{{Resource functions}}
{{Resource_functions|server}}

Latest revision as of 22:48, 6 September 2024

Checks whether the specified resource is archived. (Currently running from a ZIP file)

Syntax

bool isResourceArchived(resource resourceElement)

OOP Syntax Help! I don't understand this!

Method: resource:isArchived(...)
Variable: .archived


Required Arguments

  • resourceElement: The resource to check.

Returns

Returns true if the selected resource is archived, false if it is not archived, and nil if some kind of problem occurred.

Example

Click to collapse [-]
Example 1

This example stops the resource if it's archived. 

addEventHandler("onResourceStart", resourceRoot,
	function(resourceElement)
		if isResourceArchived(resourceElement) then
			cancelEvent()
		end
	end
)
Click to collapse [-]
Example 2 (OOP)

This example stops the resource if it's archived by using the object oriented method. (It's important to note that you need to enable OOP in meta.xml to use this) 

addEventHandler("onResourceStart", resourceRoot,
	function(resourceElement)
		if resourceElement:isArchived() then
			cancelEvent()
		end
	end
)
Click to collapse [-]
Example 3 (OOP)

This example stops the resource if it's archived by using the object oriented variable. (It's important to note that you need to enable OOP in meta.xml to use this) 

addEventHandler("onResourceStart", resourceRoot,
	function(resourceElement)
		if resourceElement.archived then
			cancelEvent()
		end
	end
)

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/IsResourceArchived?oldid=80424"