PT-BR/GetFilesInResourceFolder - Revision history

Lettify: fixed and improved

2021-09-13T00:00:05Z

fixed and improved

← Older revision		Revision as of 00:00, 13 September 2021
Line 7:		Line 7:

	===Argumento Necessário===		===Argumento Necessário===
	* '''directory''': Uma [[string/PT-BR\|string]] que especificará a pasta em que deve ser feita a listagem de arquivos.		* '''directory''': Uma [[string/PT-BR\|string]] que especificará a pasta em que deve ser feita a listagem de arquivos. Para obter todos (independente da pasta), use <code>'/'</code>

	===Argumento Opcional===		===Argumento Opcional===
Line 51:		Line 51:
	local theFile = fileOpen(thisResource and srcAttribute or ':'..nomeResource..'/'..srcAttribute)		local theFile = fileOpen(thisResource and srcAttribute or ':'..nomeResource..'/'..srcAttribute)
	if theFile then		if theFile then
	~~local filePath~~ = ~~fileGetPath(theFile)~~		if (path == '/') then
	~~filePath~~ = ~~filePath:gsub('/['..charsTypes..']+%.['..charsTypes..']+', '/'):gsub(':'..nomeResource..~~'/'~~, '')~~
	~~if (filePath == tostring(path)~~) then
	table.insert(files, srcAttribute)		table.insert(files, srcAttribute)
	table.insert(files_onlyname, onlyFileName)		table.insert(files_onlyname, onlyFileName)
			else
			local filePath = fileGetPath(theFile)
			filePath = filePath:gsub('/['..charsTypes..']+%.['..charsTypes..']+', '/'):gsub(':'..nomeResource..'/', '')
			if (filePath == tostring(path)) then
			table.insert(files, srcAttribute)
			table.insert(files_onlyname, onlyFileName)
			end
	end		end
	fileClose(theFile)		fileClose(theFile)

Lettify: Fix: Syntax

2020-08-30T18:13:45Z

Fix: Syntax

← Older revision		Revision as of 18:13, 30 August 2020
Line 4:		Line 4:

	==Sintaxe==		==Sintaxe==
	<syntaxhighlight lang="lua">table, table getFilesInResourceFolder ( string directory, resource theResource )</syntaxhighlight>		<syntaxhighlight lang="lua">table, table getFilesInResourceFolder ( string directory, [ resource theResource ] )</syntaxhighlight>

	===Argumento Necessário===		===Argumento Necessário===

Lettify: Formato de código de retorno

2020-08-30T15:49:14Z

Formato de código de retorno

← Older revision		Revision as of 15:49, 30 August 2020
Line 16:		Line 16:
	Retorna duas [[PT-BR/Table\|tabelas]], a 1° armazenando o nome/caminho dos arquivos obtidos, e a 2° armazenando somente o nome dos arquivos (com suas respectivas extensões). Senão retorna ''false''.		Retorna duas [[PT-BR/Table\|tabelas]], a 1° armazenando o nome/caminho dos arquivos obtidos, e a 2° armazenando somente o nome dos arquivos (com suas respectivas extensões). Senão retorna ''false''.
	======Formato do valor retornado======		======Formato do valor retornado======
	* 1° tabela:		* 1° tabela: <code style='color: green'> {<b>'Pasta1/Pasta2/arquivo.ext'</b>, <b>'Pasta1/arquivo2.ext'</b>, <b>'arquivo3.ext'</b>} </code>
	<~~syntaxhighlight lang~~=~~"lua"~~>		* 2° tabela: <code style='color: green'> {<b>'arquivo.ext'</b>, <b>'arquivo2.ext'</b>, <b>'arquivo3.ext'</b>} </code>
	{'Pasta1/Pasta2/arquivo.ext', 'Pasta1~~/Pasta2~~/arquivo2.ext', '~~Pasta1/Pasta2/~~arquivo3.ext'}
	</~~syntaxhighlight~~>
	* 2° tabela:
	<~~syntaxhighlight lang~~=~~"lua"~~>
	{'arquivo.ext', 'arquivo2.ext', 'arquivo3.ext'}
	</~~syntaxhighlight~~>

	==Código fonte==		==Código fonte==

Lettify at 04:48, 30 August 2020

2020-08-30T04:48:09Z

← Older revision		Revision as of 04:48, 30 August 2020
Line 1:		Line 1:
	{{PT-BR/Função Útil}}~~<lowercasetitle></lowercasetitle>~~__NOTOC__		{{PT-BR/Função Útil}}__NOTOC__
	Esta função lista todos os arquivos em uma pasta de resource. '''OBS''': Esta função deve somente ser executada em server-side.		Esta função lista todos os arquivos em uma pasta de resource. '''OBS''': Esta função deve somente ser executada em server-side.
	{{BR/Nota\|A listagem só é feita com arquivos que estão registrado no arquivo '''meta.xml''' em atributos de nome '''src'''.}}		{{BR/Nota\|A listagem só é feita com arquivos que estão registrado no arquivo '''meta.xml''' em atributos de nome '''src'''.}}

Lettify: Lettify moved page GetFilesInResourceFolder/PT-BR to PT-BR/GetFilesInResourceFolder: Mantendo o padrão aplicado

2020-08-30T04:46:38Z

Lettify moved page GetFilesInResourceFolder/PT-BR to PT-BR/GetFilesInResourceFolder: Mantendo o padrão aplicado

← Older revision

Revision as of 04:46, 30 August 2020

Lettify: Alguma sugestão ou crítica? Me contate :D

2020-08-30T04:38:13Z

Alguma sugestão ou crítica? Me contate :D

New page

{{PT-BR/Função Útil}}<lowercasetitle></lowercasetitle>__NOTOC__
Esta função lista todos os arquivos em uma pasta de resource. '''OBS''': Esta função deve somente ser executada em server-side.
{{BR/Nota|A listagem só é feita com arquivos que estão registrado no arquivo '''meta.xml''' em atributos de nome '''src'''.}}

==Sintaxe==
<syntaxhighlight lang="lua">table, table getFilesInResourceFolder ( string directory, resource theResource )</syntaxhighlight>

===Argumento Necessário===
* '''directory''': Uma [[string/PT-BR|string]] que especificará a pasta em que deve ser feita a listagem de arquivos.

===Argumento Opcional===
{{BR/ArgOpcional}}
* '''theResource''': Um [[PT-BR/Recursos|resource]](userdata) que será feita a busca. Caso não especificado, a busca é feita no resource em que a função foi executada.

===Retorna===
Retorna duas [[PT-BR/Table|tabelas]], a 1° armazenando o nome/caminho dos arquivos obtidos, e a 2° armazenando somente o nome dos arquivos (com suas respectivas extensões). Senão retorna ''false''.
======Formato do valor retornado======
* 1° tabela:
<syntaxhighlight lang="lua">
{'Pasta1/Pasta2/arquivo.ext', 'Pasta1/Pasta2/arquivo2.ext', 'Pasta1/Pasta2/arquivo3.ext'}
</syntaxhighlight>
* 2° tabela:
<syntaxhighlight lang="lua">
{'arquivo.ext', 'arquivo2.ext', 'arquivo3.ext'}
</syntaxhighlight>

==Código fonte==
<section name="Lado servidor" class="server" show="false">
<syntaxhighlight lang="lua">
function getFilesInResourceFolder(path, res)
if (triggerServerEvent) then error('A função @getFilesInResourceFolder deve ser usada somente em server-side', 2) end

if not (type(path) == 'string') then
error("@getFilesInResourceFolder argumento #1. Esperado uma 'string', obtido '"..type(path).."'", 2)
end

if not (tostring(path):find('/$')) then
error("@getFilesInResourceFolder argumento #1. O caminho deve conter '/' no final para certificar que seja um diretório.", 2)
end

res = (res == nil) and getThisResource() or res
if not (type(res) == 'userdata' and getUserdataType(res) == 'resource-data') then
error("@getFilesInResourceFolder argumento #2. Esperado um 'resource-data', obtido '"..(type(res) == 'userdata' and getUserdataType(res) or tostring(res)).."' (tipo: "..type(res)..")", 2)
end

local files = {}
local files_onlyname = {}
local thisResource = res == getThisResource() and res or false
local charsTypes = '%.%_%w%d%|%\%<%>%:%(%)%&%;%#%?%*'
local nomeResource = getResourceName(res)
local Meta = xmlLoadFile(':'..nomeResource..'/meta.xml')
if not Meta then error("(@getFilesInResourceFolder) Não foi possível obter o 'meta.xml' do resource '"..nomeResource.."'", 2) end
for _, nod in ipairs(xmlNodeGetChildren(Meta)) do
local srcAttribute = xmlNodeGetAttribute(nod, 'src')
if (srcAttribute) then
local onlyFileName = tostring(srcAttribute:match('/(['..charsTypes..']+%.['..charsTypes..']+)') or srcAttribute)
local theFile = fileOpen(thisResource and srcAttribute or ':'..nomeResource..'/'..srcAttribute)
if theFile then
local filePath = fileGetPath(theFile)
filePath = filePath:gsub('/['..charsTypes..']+%.['..charsTypes..']+', '/'):gsub(':'..nomeResource..'/', '')
if (filePath == tostring(path)) then
table.insert(files, srcAttribute)
table.insert(files_onlyname, onlyFileName)
end
fileClose(theFile)
else
outputDebugString("(@getFilesInResourceFolder) Não foi possível verificar o arquivo '"..onlyFileName.."' do resource '"..nomeResource.."'", 2)
end
end
end
xmlUnloadFile(Meta)
return #files > 0 and files or false, #files_onlyname > 0 and files_onlyname or false
end
</syntaxhighlight>
</section>
<br>
==Exemplos==
====Exemplo 1====
<section name="Lado servidor" class="server" show="true">
Este exemplo cria o comando '''/arquivosde <pasta> [resource]''' que exibe no chat algumas informações sobre os dados obtidos da busca de arquivos.
<syntaxhighlight lang="lua">
function verArquivos(player, cmd, folderName, resName)
if (hasObjectPermissionTo(player, 'function.banPlayer', false)) then -- O jogador só prosseguirá com este comando se tiver permissão de banir
if (folderName) then -- Se especificou o nome da pasta, então
local theRes
if (resName) then -- Se especificou o nome do resource então o definiremos
theRes = getResourceFromName(tostring(resName))
if not theRes then -- Se não houver resource com o nome especificado, então avisaremos
return outputChatBox("#FF0000##FFFFFF Não existe resource com o nome '"..resName.."'", player, 255, 255, 255, true)
end
end
local files, onlyFilesName = getFilesInResourceFolder(folderName, theRes) -- então faremos a busca
if (files and onlyFilesName) then -- Se deu tudo certo, então mostraremos os dados de resposta
outputChatBox('===== Arquivos obtidos! =====', player, 255, 255, 255, true)
outputChatBox('=> Pasta: '..tostring(folderName), player, 255, 255, 255, true)
outputChatBox('=> Resource: '..tostring(resName), player, 255, 255, 255, true)
outputChatBox('=> Total de arquivos: '..tostring(#files)..' arquivos', player, 255, 255, 255, true)
outputChatBox('=> Arquivos: #00FF00'..tostring(table.concat(onlyFilesName, ', ')), player, 255, 255, 255, true)
outputChatBox('==============================', player, 255, 255, 255, true)
else
outputChatBox('Não foi possível obter a lista de arquivos', player)
end
else
outputChatBox('Especifique o nome da pasta que você quer procurar os arquivos', player)
end
else
outputChatBox('# Você não tem permissão para executar este comando.', player, 255, 0, 0, false)
end
end
addCommandHandler('arquivosde', verArquivos)
</syntaxhighlight>
</section>

====Exemplo 2====
<section name="Lado servidor" class="server" show="true">
Este exemplo cria o comando '''/arquivosaqui <pasta>''' que exibe no chat informações sobre os arquivos obtidos pela função útil.
<syntaxhighlight lang="lua">
function verArquivos(player, cmd, folderName)
if (hasObjectPermissionTo(player, 'function.banPlayer', false)) then -- Somente prosseguirá com este comando quem tiver permissão para banir jogadores
if (folderName) then -- Se especificou o nome da pasta que quer buscar, então...
local files, onlyFilesName = getFilesInResourceFolder(folderName)
if (files and onlyFilesName) then -- Se obtivemos dados sobre os arquivos, então exibiremos
outputChatBox('===== Arquivos obtidos! =====', player, 255, 255, 255, true)
outputChatBox('=> Pasta: '..tostring(folderName), player, 255, 255, 255, true)
outputChatBox('=> Resource: '..getResourceName(getThisResource()), player, 255, 255, 255, true)
outputChatBox('=> Total de arquivos: '..tostring(#files)..' arquivos', player, 255, 255, 255, true)
outputChatBox('=> Arquivos: #00FF00'..tostring(table.concat(onlyFilesName, ', ')), player, 255, 255, 255, true)
outputChatBox('==============================', player, 255, 255, 255, true)
else
outputChatBox('#FF0000##FFFFFF Não foi possível obter os arquivos na pasta especificada', player, 255, 255, 255, true)
end
else
outputChatBox('#FF0000##FFFFFF Especifique o nome da pasta que queira buscar', player, 255, 255, 255, true)
end
else
outputChatBox('# Você não tem permissão para executar este comando', player, 255, 0, 0, false)
end
end
addCommandHandler('arquivosaqui', verArquivos)
</syntaxhighlight>
</section>

==Créditos==
*'''Autor:''' [[User:Lettify|KronoS Lettify]].
<br>
==See Also==
{{Useful_Functions}}