Adicionar um componente ao caminho (file.path.add_component)

Declaração

novo_caminho, mensagem_de_erro = file.path.add_component(caminho, componente)

Parâmetros

• caminho
  Texto; string do caminho base
• componente
  Texto; componente de caminho a adicionar

Valores retornados

• novo_caminho
  Texto ou nil; retorna o caminho com o componente adicionado em caso de sucesso, ou nil se o caminho ou componente for inválido
• mensagem_de_erro
  Texto; retorna "Invalid path" se o caminho ou componente for inválido

Observações

Adiciona o componente indicado ao caminho base e trata automaticamente o separador / na junção
Esta função apenas gera uma string de caminho; não cria arquivos ou diretórios reais
Esta função está disponível somente em versões posteriores a 20250914

Exemplo

local full_path = file.path.add_component("/usr/local", "bin") -- Retorna "/usr/local/bin"
local tmp_path = file.path.add_component("/", "tmp") -- Retorna "/tmp"