Object to path
Object to path ( objRota ) : Text
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| objRota | Object | → | Objeto que descreve os conteúdos da rota |
| Resultado | Text | ← | Nome da rota |
Descrição
O comando Object to path devolve um nome de rota (string) em função da informação de rota que passou no parâmetro objRota. As rotas abaixo são suportadas:
- Rota de sistema (Windows ou macOS) ou rota Posix. O tipo de rota está definido pelo último caractere da propriedade parentFolder (ver a seguir).
- Rota relativa ou rota absoluta (ver Via de acesso absoluta ou relativa para saber mais).
Em objRota, passe um objeto que define a rota que deseja gerar. Deve conter as propriedades abaixo:
| Propriedade | Tipo | Descrição |
|---|---|---|
| parentFolder | Texto | Informação de diretório para a rota. P último caractere deve ser um separador de pasta. O comando usa este caractere para conhecer o tipo de rota. Se se tratar de um separador Posix ("/"), a rota é criada com os separadores Posix; do contrário, se usar o separador de sistema. |
| name | Texto | Nome final de arquivo ou pasta da rota especificada sem extensão. |
| extension | Texto | Extensão de nome final de arquivo ou pasta. Começa com "." (pode ser omitido). String vazia "" se não houver extensão. |
| isFolder | Booleano | True se o nome for um nome de pasta, do contrário, false (o valor pré-determinado for false) |
Geralmente, objRota será gerado com o comando Path to object , entretanto, o objeto pode ser gerado com qualquer meio. Lembre que Object to path só maneja strings. Tampouco comprova se a rota é válida com respeito ao tipo de rota, nem a existência real de nenhum arquivo ou pasta.
Exemplo
Se quisermos duplicar e mudar o nome de um arquivo em sua própria pasta
var $o : Object
$o:=New object
var $path : Text
$path:="C:\\MyDocs\\file.txt"
$o:=Path to object($path)
$o.name:=$o.name+"_copy"
COPY DOCUMENT($path;Object to path($o))
Ver também
Convert path POSIX to system
Convert path system to POSIX
File
Folder
Path to object
Test path name
Propriedades
| Número do comando | 1548 |
| Thread-seguro | ✓ |