Object to path

4D v20 R7

Object to path


Object to path ( objRota ) -> Resultado

Parâmetro	Tipo	Descrição
objRota	Objeto	Objeto que descreve os conteúdos da rota
Resultado	Texto	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

 C_OBJECT($o)

 $o:=New object

 C_TEXT($path)

 $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