pathListDir

Lista os nomes que estão diretamente dentro de uma pasta do resource.

Sintaxe

table pathListDir ( string caminho )

Parâmetros

Nome	Tipo	Padrão	Descrição
caminho	string	—	Pasta relativa à pasta do resource. String vazia ou "." é a raiz do resource (no cliente só "."; string vazia é recusada).

Só um nível é listado, e o resultado mistura arquivos e pastas: são nomes puros, sem o caminho que leva até eles. No servidor a ordem não é garantida — ordene você mesmo se precisar de uma. O cliente devolve os nomes em ordem alfabética, sem diferenciar maiúsculas e minúsculas.

Retorno

Tabela de nomes, ou nil quando o caminho é inválido ou não é uma pasta. Uma pasta vazia devolve uma tabela vazia.

No cliente as duas falhas também registram um aviso, e um caminho que não seja string levanta um erro (Bad argument @ 'pathListDir' [...]) que interrompe o código chamador em vez de retornar.

for _, nome in ipairs(pathListDir("assets") or {}) do
    if pathIsDirectory("assets/" .. nome) then
        outputDebugString(nome .. "/")
    else
        outputDebugString(nome)
    end
end

Nota

No cliente não existe árvore de diretórios, só os caminhos lógicos que o resource baixou. Uma pasta é, portanto, qualquer prefixo que esses caminhos compartilham: o pathListDir lista o que existe no armazenamento do resource, e uma pasta vazia é indistinguível de uma que nunca foi declarada. Um caminho que começa com @ lista os arquivos privados do resource.

No servidor, lendo dentro de outro resource, só os nomes que o seu manifesto declarou são listados. Um nome sobre o qual você não tem direito fica de fora, então a tabela nunca revela que ele existe. No cliente todos os nomes do outro resource são listados.

Veja também

• fileOpen — Abre um arquivo existente.
• fileCreate — Cria um arquivo novo, ou zera um que já exista.
• fileClose — Grava as alterações pendentes no disco e fecha o arquivo.
• fileFlush — Grava no disco o que foi escrito até agora, sem fechar o arquivo.
• fileRead — Lê bytes a partir da posição atual.
• fileWrite — Escreve uma ou mais strings a partir da posição atual.
• fileGetContents — Devolve o conteúdo inteiro do arquivo.
• fileGetSize — Devolve o tamanho do arquivo em bytes.