LODS: portuguese version indexed

2021-11-14T18:27:13Z

portuguese version indexed

← Older revision		Revision as of 18:27, 14 November 2021
Line 92:		Line 92:
	==See Also==		==See Also==
	{{Useful_Functions}}		{{Useful_Functions}}
			[[pt-br:GetResourceSize]]

Lettify: Created page with "{{Useful Function}}NOTOC This function returns the size of a specified resource in '''kB'''(kilobyte). Resource files that are not declare..."

2020-05-18T05:50:04Z

Created page with "{{Useful Function}}<lowercasetitle></lowercasetitle>__NOTOC__ This function returns the size of a specified resource in '''kB'''(kilobyte). Resource files that are not declare..."

New page

{{Useful Function}}<lowercasetitle></lowercasetitle>__NOTOC__
This function returns the size of a specified resource in '''kB'''(kilobyte). Resource files that are not declared in [[meta]] are not counted.

==Syntax==
<syntaxhighlight lang="lua">float getResourceSize ( string/resource theResource )</syntaxhighlight>

===Required Arguments===
* '''theResource''': A [[string]] containing the name of the resource or the [[resource]] object (non-element) to obtain the size.

===Returns===
Returns a [[float]] size of the resource counting the meta. Otherwise it returns ''false''.

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getResourceSize(theResource)
local actLine = tostring(debug.getinfo(2, 'l').currentline)
assert(theResource and type(theResource) == 'string' or type(theResource) == 'userdata', "@ 'getResourceSize' (Line "..actLine..") Expected 'resource' or 'resource-name', got '"..type(theResource).."'")

local res =
(type(theResource) == 'string' and getResourceFromName(tostring(theResource)))
or
(type(theResource) == 'userdata' and getUserdataType(theResource) == 'resource-data' and theResource)
or false

if not res then return false end

local resourceName = getResourceName(res)
local sizeB = 0
local metaXML = xmlLoadFile(':'..resourceName..'/meta.xml')

if (metaXML) then
for _, v in ipairs(xmlNodeGetChildren(metaXML)) do
local attribute = xmlNodeGetAttribute(v, 'src')
if (attribute) then
local file = fileOpen(':'..resourceName..'/'..attribute)
if (file) then
sizeB = sizeB + fileGetSize(file)
fileClose(file)
end
end
end
return tonumber(string.format('%.3f', sizeB/1024))
end
return false
end
</syntaxhighlight>
</section>
<br>
==Examples==
This first example creates a command handler with the following syntax '''/viewsize <resource_name>'''.
<section name="Lado servidor" class="server" show="true">
<syntaxhighlight lang="lua">
function resSize(player, cmd, resName)
if (resName) then
local size = getResourceSize(tostring(resName))
if (size) then
outputChatBox("The size of resource '"..tostring(resName).."' is "..tostring(size).."kB", player)
else
outputChatBox('Could not get a size, check the specified arguments.', player)
outputChatBox('Possible mistakes: \nArg#1 is not a string or userdata\nResource with the specified name was not found', player)
end
else
outputChatBox('Specify a name of a resource', player)
end
end
addCommandHandler('viewsize', resSize)
</syntaxhighlight>
</section>

<br>

This second example creates a command handler with the following syntax '''/sizeofthis''' which output in chatbox the size of the resource on which the command was executed.
<section name="Lado servidor" class="server" show="true">
<syntaxhighlight lang="lua">
function resSize(player, cmd)
local size = getResourceSize(getThisResource())
if (size) then
outputChatBox("The size of this resource("..getResourceName(getThisResource())..") is "..tostring(size).."kB", player)
else
outputChatBox('Could not get a size, check the specified arguments.', player)
outputChatBox('Possible mistakes: \nArg#1 is not a string or userdata\nResource with the specified name was not found', player)
end
end
addCommandHandler('sizeofthis', resSize)
</syntaxhighlight>
</section>

==Credits==
*'''Author:''' [[User:Lettify|KronoS Lettify]].
<br>
==See Also==
{{Useful_Functions}}

GetResourceSize - Revision history

LODS: portuguese version indexed

Lettify: Created page with "{{Useful Function}}__NOTOC__ This function returns the size of a specified resource in '''kB'''(kilobyte). Resource files that are not declare..."

Lettify: Created page with "{{Useful Function}}NOTOC This function returns the size of a specified resource in '''kB'''(kilobyte). Resource files that are not declare..."