getElementsByType

Busca todos os elementos de um tipo.

Sintaxe

-- servidor
table getElementsByType ( string tipo [, element comecarEm = root ] )

-- cliente
table getElementsByType ( string tipo [, element comecarEm = root, bool apenasCarregados = false ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
tipo	string	—	Nome do tipo procurado.
comecarEm	element	root	Limita a busca a essa subárvore.
apenasCarregados	bool	false	Só no cliente. Com true, devolve apenas os elementos que estão carregados no mundo neste momento. Só é lido quando comecarEm é informado como elemento, então passe root explicitamente. Tipos que nunca são carregados por streaming — tudo que não for jogador, ped, veículo, objeto, arma, pickup, marcador ou holofote — sempre entram no resultado.

O cliente tem um terceiro argumento que o servidor não tem — ele é o único caso em que a versão do cliente recebe mais coisas que a do servidor. No servidor, passar um terceiro argumento simplesmente não faz nada.

Retorno

Tabela com os elementos encontrados, ou false se comecarEm for inválido. A busca desce por toda a subárvore e inclui o próprio comecarEm quando ele bate com o tipo. No cliente ela cobre os elementos que aquele cliente conhece.

Exemplo

-- servidor
for _, jogador in ipairs(getElementsByType("player")) do
    setElementHealth(jogador, 100)
end

-- só os veículos deste resource (funciona nos dois lados)
local meusVeiculos = getElementsByType("vehicle", resourceRoot)

-- cliente: só os veículos que já estão carregados por perto
local porPerto = getElementsByType("vehicle", root, true)

Veja também

• getElementByID — Encontra um elemento pelo identificador.
• getElementByIndex — Devolve o n-ésimo elemento de um tipo.