Quebra em diversas partes um arquivo.
Sintaxe
SPLITPATH( cArq, @[cDrive], @[cCaminho], @[cNome], @[cExt] ) –> NIL
Argumento | Obrigat. | Tipo | Descrição |
cArq | Sim | C | Nome do Arquivo a ser quebrado. Opcionalmente, pode incluir caminho e drive. |
cDrive | Não | C | Nome do Drive. Exemplo ( C: ). Caso o Arquivo informado não possua drive ou o caminho refira-se ao servidor, retorno será uma string em branco. |
cCaminho | Não | C | Nome do Caminho. Caso o Arquivo informado não possua caminho, será uma string em branco. |
cNome | Não | C | Nome do Arquivo sem a extensão, caso em cArq não seja especificado um nome do Arquivo retornará uma string em branco. |
cExt | Não | C | Nome do Arquivo sem a extensão, caso em cArq não seja especificado um Arquivo com extensão retornará uma string em branco |
Retorno | Descrição |
NIL | Sem retorno |
Descrição
SplitPath() divide um caminho completo em todas as suas subpartes; cArq não necessita conter todas as partes.
Tanto arquivos locais ( Remote ) quanto arquivos no servidor, podem ser informados.
O caminho, caso informado, incluirá uma barra como último caracter.
A extensão inclui sempre o ponto ( . ) antes da extensão.
Todos os parâmetros quando passados devem ser por referência.
Exemplo
Local cArq := “C:TEMPTESTE.EXE”
Local cDrive, cDir, cNome, cExt
SplitPath( cArq, @cDrive, @cDir, @cNome, @cExt )
? cDrive // Resultado : C:
? cDir // Resultado : TEMP
? cNome // Resultado : TESTE
? cExt // Resultado: .EXE